mcp-server-and-agent

状态：进行中。 已搭建脚手架，尚未实现。一旦首批结果落地，本 README 将包含生成的数字。

一个在协议层面手写的 MCP 服务器，外加一个基于它的 LangGraph agent，用同一组任务运行四种拓扑结构，并测量它们的失败模式。

这个仓库回答一个问题：

每种 agent 拓扑的失败率是多少？supervisor 真的能胜过 single-agent 吗？

这里的一切都服务于回答这个问题。无助于回答它的功能都不在范围内——这是有意为之。

为什么存在

快速开始

uv sync --extra dev
uv run pytest -q
uv run python scripts/generate_results.py

结果

尚无结果。

设计决策

局限性

涵盖的概念

• 2C 手写 MCP 服务器加 LangGraph agent（DO-8）

• 2C ReAct、plan-and-execute、reflection

• 2C 拓扑及其失败模式

• 2C 工具设计：schema 清晰度、粒度、错误作为模型反馈、幂等性、确认门

• 2C MCP 作为协议：传输、发现、资源、提示、采样、OAuth 范围

• 2C 状态与记忆、检查点、持久执行

• ……还有 4 个（见 docs/inventory-coverage.md）

许可证

MIT