KawhiWei/nino-agent

Nino Agent 是一个 API-first、多语言可演进的 Agent Harness 项目。当前可执行版本使用 Python 3.12，提供通用 Orchestrator、受控 Specialist ReAct Worker、共享 Agent/Skill 契约、多 MCP ToolProvider、SQLite 多轮会话和 Loop Engineering。独立的 .NET MCP Ser

About nino-agent

Nino Agent 是一个 API-first、多语言可演进的 Agent Harness 项目。当前可执行版本使用 Python 3.12，提供通用 Orchestrator、受控 Specialist ReAct Worker、共享 Agent/Skill 契约、多 MCP ToolProvider、SQLite 多轮会话和 Loop Engineering。独立的 .NET MCP Server 提供演示数据能力。

- FastAPI REST + SSE，不依赖 CLI 作为产品入口。 - 严格 Skill 白名单的 nino.orchestrator；越界请求在模型调用前固定拒绝，命中请求必须 dispatch。 - lightweight 与 LangGraph 两种 Specialist ReAct Worker。 - 原生 OpenAI-compatible 与 LangChain 模型 Adapter。 - OpenAI-compatible Tool Calling 和可选 reasoningcontent 回传。 - 多 MCP Server 发现、Tool 名称冲突检测、必需/可选服务故障隔离。 - Agent + Skill 双重 Tool 白名单、Reference 按需加载和目录逃逸保护。 - SQLite Conversation、Message、Run、Event、上下文摘要与 Loop checkpoint。 - 基于 token 预算的溢出压缩；短会话不会重复压缩。 - Loop step/action/timeout/连续失败/无进展/重复 Action 约束。 - Docker Compose 启动 Runtime、.NET MCP 和 PostgreSQL。

当前没有实现 ACP Adapter、Web 前端、身份认证、多实例共享存储、写操作审批、持久化任务图和 进程重启后的自动 Loop resume。这些能力不会在文档中描述成已完成。

Framework 不引用 FastAPI、SQLite、httpx、LangChain、LangGraph 或 MCP SDK。

主模型只看到候选能力摘要和 ninoruntimedispatchagent，看不到业务 MCP Tools。选中的 Specialist 才加载完整 Skill、References 和白名单内 MCP schema。

严格边界由 Harness 执行：先应用 excludedintentkeywords，再匹配 intentkeywords；未命中时不调用模型并产生 policyrejected(OUTOFSCOPE)；命中后主模型不得零 dispatch 直接回答；Worker 没有成功 Tool Observation 时只能返回不超过 500 字符且包含明确补充信息要求的澄清问题。父 Orchestrator 只有 至少一个子 Agent 成功完成后才能生成最终答案。

澄清不是自由文本例外：Worker 必须调用内部结构化 Action ninoruntimerequestclarification，Harness 校验后以 clarificationrequested 事件完成。

- kind: orchestration 或 workerreact。 - status: running/completed/failed/cancelled。 - step/maxsteps。 - actioncount/maxactions。 - successfulactions/failedactions/consecutivefailures/noprogresssteps。 - elapsedms/timeouts

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/KawhiWei--nino-agent.html)

Related MCP servers