MCP代理编排系统

使用模型上下文协议 (MCP) 的基于状态的代理编排系统的 Python 实现。

什么是 MCP？

模型上下文协议 (MCP) 允许应用程序以标准化的方式为 LLM 提供上下文，从而将提供上下文的关注点与实际的 LLM 交互分离开来。使用 MCP，您可以构建服务器来公开：

• 资源：为法学硕士提供信息的数据源

• 工具：允许 LLM 执行操作的功能

• 提示：可重复使用的 LLM 交互模板

Related MCP server: MCP-RAG

安装

先决条件

• Python 3.10 或更高版本

• MCP Python SDK 1.2.0 或更高版本

设置您的环境

使用 uv（推荐）

使用 pip

克隆或下载项目文件

将项目文件放在您的目录中：

• orchestrator.py - 实现状态机的主 MCP 服务器

• orchestrator_client.py - 演示编排流程的客户端

• requirements.txt - 项目依赖项

• .gitignore - Git 忽略文件

项目结构

• orchestrator.py - 实现状态机的主 MCP 服务器

• orchestrator_client.py - 演示编排流程的客户端

• requirements.txt - 项目依赖项

运行编排系统

1. 直接启动编排服务器进行测试：

2. 在单独的终端中，运行客户端以查看实际的编排过程：

与 Claude 桌面版集成

1. 安装 Claude 桌面版

确保已安装 Claude 桌面版。您可以从Anthropic 网站下载最新版本。

2. 配置 Claude 桌面版

1. 打开您的 Claude for Desktop 配置文件：

   macOS/Linux：

   # Create or edit the configuration file code ~/Library/Application\ Support/Claude/claude_desktop_config.json

   视窗：

   # Path may vary depending on your Windows version code %APPDATA%\Claude\claude_desktop_config.json

2. 添加 Orchestrator 服务器配置：

   { "mcpServers": { "agent-orchestrator": { "command": "python", "args": [ "/ABSOLUTE/PATH/TO/YOUR/PROJECT/orchestrator.py" ] } } }

   将该路径替换为 Orchestrator.py 文件的绝对路径。

3. 保存配置文件并重新启动 Claude for Desktop。

3. 在 Claude 中使用 Orchestrator

配置完成后，您可以：

1. 打开 Claude 桌面版

2. 点击侧边栏中的 MCP 服务器图标

3. 从可用服务器列表中选择“agent-orchestrator”

4. 开始与编排系统交互

克劳德将能够：

• 不同代理状态之间的转换

• 从知识库存储和检索信息

• 在状态转换过程中保持对话上下文

• 访问特定于状态的提示

代理状态

编排系统实现了一个具有以下状态的状态机：

• IDLE ：等待指令

• 规划：为任务创建结构化计划

• 研究：收集任务所需的信息

• 执行：执行计划的行动

• 审查：评估结果并确定下一步行动

• ERROR ：处理错误或意外情况

定制系统

添加新州

1. 将状态添加到orchestrator.py中的AgentState枚举中

2. 为新状态创建提示函数

3. 更新_get_available_transitions()中的转换逻辑

4. 在资源访问函数中添加新状态的处理程序

创建自定义工具

通过创建用@mcp.tool()装饰的函数来添加新工具：

开发和测试

使用 MCP CLI

MCP CLI 提供开发和测试工具：

使用 Python 进行手动测试

资源

• MCP Python SDK 文档

• 模型上下文协议规范

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。