使用说明
MCP Orchestration Server - 多代理开发环境
多个Claude Code 打开实例MCP (Model Context Protocol) 合并Orchestrator Agent 是管理其他子代理（Planning，Implementation，Testing）的系统。
🎯 概要
Cursor/Claude Code (Orchestrator)
↓ MCP
MCP Orchestration Server (Redis)
↓ MCP
複数の Cursor/Claude Code (Planning, Implementation, Testing Agent)
📁 目录配置
Orchestrations/
├── mcp-server/ # MCP サーバー実装
│ ├── src/
│ │ └── index.ts # メインサーバーコード
│ ├── package.json
│ ├── tsconfig.json
│ └── .env.example
├── claude-code-configs/ # Claude Code 設定ファイル
│ ├── orchestrator-config.json # Orchestrator 用
│ ├── planning-agent-config.json # Planning Agent 用
│ ├── implementation-agent-config.json # Implementation Agent 用
│ └── testing-agent-config.json # Testing Agent 用
├── mcp-orchestration-architecture.md # システムアーキテクチャ
├── agent-protocols.md # 通信プロトコル詳細
├── comprehensive_orchestration_guide.md # 総合ガイド
├── setup.bat # Windows セットアップスクリプト
└── README.md # このファイル
🚀 快速启动
前提条件
- Node.js 18.0.0 以上
- Docker 桌面版 (Redis 用)
- 光标 或 克劳德代码 (VSCode 扩张机能）
安装过程
1.自动设置（推荐）
# Windows
setup.bat
2.手动设置
# 1. MCP Server のビルド
cd mcp-server
npm install
npm run build
# 2. 環境変数の設定
copy .env.example .env
# 3. Redis の起動
docker run -d --name redis-orchestration -p 6379:6379 redis:7.2-alpine
# 4. MCP Server の起動
npm run dev
Cursor/Claude Code 配置
每个代理 分别的Cursor 窗口 打开颜色区分和MCP进行设置。
🎨 工作区准备（分色设置）
# 各エージェント用のワークスペースフォルダを作成
mkdir agent-workspaces\orchestrator
mkdir agent-workspaces\planning-agent
mkdir agent-workspaces\implementation-agent
mkdir agent-workspaces\testing-agent
# 色分け設定をコピー
xcopy workspace-configs\orchestrator\.vscode agent-workspaces\orchestrator\.vscode /E /I
xcopy workspace-configs\planning-agent\.vscode agent-workspaces\planning-agent\.vscode /E /I
xcopy workspace-configs\implementation-agent\.vscode agent-workspaces\implementation-agent\.vscode /E /I
xcopy workspace-configs\testing-agent\.vscode agent-workspaces\testing-agent\.vscode /E /I
启动和配置每个代理
｜代理｜颜色｜启动方法｜
|------------|-----|---------|
| 🎯 编排器 | 紫 | cd agent-workspaces\orchestrator && code . |
| 📋 规划代理 | 青 | cd agent-workspaces\planning-agent && code . |
| ⚙️ 实施代理 |緑| cd agent-workspaces\implementation-agent && code . |
| 🧪 测试代理 橙色 cd agent-workspaces\testing-agent && code . |
单击功能区上MCP 添加设置：
Ctrl+Shift+P→ “首选项：打开用户设置（JSON）”- 或Claude Dev 在动态输入提示中单击MCP 添加服务器
- 克劳德码配置/ 中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长
详情 工作区配置/README.md 来修改标记元素的显示属性。
📖 用法
1.启动代理
各Cursor 窗口中，提示代理自我介绍：
Planning Agent 窗口：
Planning Agent として起動してください
Implementation Agent 窗口：
Implementation Agent として起動してください
Testing Agent 窗口：
Testing Agent として起動してください
每个代理都会自动 register_agent ，然后单击poll_tasks 开始循环。
2. Orchestrator 创建任务
Orchestrator 窗口：
ユーザー認証機能を実装してください。
技術スタックは Python + FastAPI + PostgreSQL です。
Orchestrator 执行以下操作：
create_task的Planning Agent 任务get_task_status等待完成- 确认计划Implementation Agent 分配子任务
- 完成所有任务后向用户报告结果
3.确认进展
Orchestrator 窗口：
現在のエージェントの状態を確認してください
→ list_agents 将显示所有代理的状态
🛠️ 可用的MCP Tools
Orchestrator 用
- 创建任务：创建新任务
- get_task_status：获取任务状态
- 列表_代理：检查所有代理的状态
子代理
- 民意测验：获取给自己的任务
- 提交结果：报告任务执行结果
- get_shared_state：获取共享数据
- set_shared_state：保存共享数据
- 注册代理：代理注册（启动时）
📚 文档
- mcp管弦乐架构.md -系统体系结构详细信息
- 代理协议.md -代理通信协议
- 综合咨询指南 -多代理开发综合指南
🔧 故障排除
MCP Server 挂牵
症状: Claude Code 的MCP 未识别工具
解决策:
- MCP Server 确认是否启动
cd mcp-server npm run dev - 确定构建是否成功
ls dist/index.js - Cursor 重新启动
Redis 连接错误
症状: Redis Client Error
解决策:
# Redis が起動しているか確認
docker ps | findstr redis
# 起動していない場合
docker run -d --name redis-orchestration -p 6379:6379 redis:7.2-alpine
# Redis 接続テスト
docker exec -it redis-orchestration redis-cli ping
# 応答: PONG
无法获取任务
症状: poll_tasks 返回空数组
解决策:
- 确认代理是否已成功注册
Orchestrator: list_agents を実行 - 确认任务是否已添加到正确的队列中
docker exec -it redis-orchestration redis-cli > LRANGE queue:planning 0 -1
🎯 実装例
Example 1: 简单的功能实现
编排者：
シンプルなTODOリストAPIを実装してください
- GET /todos - 全TODO取得
- POST /todos - TODO作成
- DELETE /todos/{id} - TODO削除
预期行为：
- Orchestrator 的Planning Agent 任务
- Planning Agent 制定实施计划
- Orchestrator 的Implementation Agent 代码实施
- Implementation Agent 生成代码
- Orchestrator 的Testing Agent 委托
- Testing Agent 生成并执行测试代码
Example 2: 重构现有代码
编排者：
app/services/user_service.py のパスワードハッシュ化ロジックを
app/utils/security.py に切り出してリファクタリングしてください
预期行为：
- Orchestrator が Implementation Agent に直接依頼
- Implementation Agent 修改代码
- Testing Agent 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
🚧 限制和今后的改善
当前限制
- 仅支持本地环境（无生产环境认证）
- 未实现基于轮询的通信
- 代理故障时无自动恢复
今后的改善计划
- [ ] Redis Pub/Sub 实时通知
- []代理认证授权功能
- []郎史密斯/普罗米修斯統合
- [ ] Web UI 仪表板，仪表板
- 代理自动缩放
📄 许可证
MIT许可证
🤝 貢献
Issue 啊Pull Request 欢迎光临！
版本: 1.0.0 最终更新: 2025-11-16 仓库: cosara22/mcp编排服务器
🤖 内置于 克劳德代码
