MA

madebyaris/agent-orchestration

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

21 stars 3 forks 质量 73 趋势 10MIT

代理编排:MCP服务器支持多代理协作,支持共享内存、任务队列、资源锁定、光标规则和 AGENTS.md 工作流程。

概览

一款模型上下文协议(MCP)服务器,支持多个AI代理共享内存、协调任务,并在集成开发环境(IDE)和CLI工具间有效协作。 当运行多个AI代理时,它们面临关键的协调挑战: 1. - 代理不知道是否轮到自己行动,导致竞赛条件 2.- 代理从文件预测状态,而非共享内存,导致读取过时 3.- 并行代理对代码库理解不一致 4.- 代理不知道其他代理正在处理同一项目 5.- 多个代理可能同时尝试同一任务 6.

概述(AI 翻译)

一款模型上下文协议(MCP)服务器,支持多个AI代理共享内存、协调任务,并在集成开发环境(IDE)和CLI工具间有效协作。

问题

当运行多个AI代理时,它们面临关键的协调挑战:

  1. 无转弯意识 - 代理不知道是否轮到自己行动,导致竞速条件
  2. 基于文件的预测 - 代理从文件中预测状态,而非共享内存,导致读取过时
  3. 上下文漂移 - 并行代理对代码库的理解不一致
  4. 无代理发现 - 代理不知道同一项目中还有其他代理
  5. 重复工作 - 多个代理可以同时尝试同一任务
  6. 编辑冲突 - 缺乏协调,代理会覆盖彼此的更改

解决方案

该MCP服务器提供:

  • 共享内存 - 代理可以存储和检索上下文、决策和发现
  • 任务队列 - 带有依赖关系的回合制任务执行
  • 代理发现 - 代理可以看到其他参与项目的人员
  • 资源锁定 - 防止文件或资源的并发访问

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Agent Orchestration

A Model Context Protocol (MCP) server that enables multiple AI agents to share memory, coordinate tasks, and collaborate effectively across IDEs and CLI tools.

The Problem

When running multiple AI agents, they face critical coordination challenges:

  1. No Turn Awareness - Agents don’t know if it’s their turn to act, leading to race conditions
  2. File-Based Prediction - Agents predict state from files, not shared memory, causing stale reads
  3. Context Drift - Parallel agents develop inconsistent understanding of the codebase
  4. No Agent Discovery - Agents are unaware of other agents working on the same project
  5. Duplicate Work - Multiple agents may attempt the same task simultaneously
  6. Conflicting Edits - Without coordination, agents overwrite each other’s changes

Solution

This MCP server provides:

  • Shared Memory - Agents can store and retrieve context, decisions, and findings
  • Task Queue - Turn-based task execution with dependencies
  • Agent Discovery - Agents can see who else is working on the project
  • Resource Locking - Prevent concurrent access to files or resources
  • Research-First Workflow - Ensures agents understand context before coding
  • Coordination Status - Real-time visibility into the orchestration state
  • Auto Context Sync - Automatically updates activeContext.md for easy reference

Compatibility

Works with any AI coding agent that supports MCP or AGENTS.md:

  • OpenAI Codex
  • Google Jules
  • Cursor
  • Aider
  • Windsurf
  • VS Code Copilot
  • GitHub Copilot Coding Agent
  • Devin
  • And many more!

Quick Start

No installation required! Just use npx:

For Any IDE/CLI (AGENTS.md)

# Navigate to your project
cd /path/to/your/project

# Initialize with AGENTS.md
npx agent-orchestration init

This creates AGENTS.md with full orchestration instructions that work with any AI coding agent.

For Cursor IDE

# Navigate to your project
cd /path/to/your/project

# Initialize for Cursor (copies .cursor/rules/)
npx agent-orchestration init-cursor

This copies .cursor/rules/ with Cursor-specific rules.

CLI Commands

npx agent-orchestration init           # Create AGENTS.md (works with any AI agent)
npx agent-orchestration init-cursor    # Setup for Cursor IDE (.cursor/rules/)
npx agent-orchestration serve          # Run the MCP server
npx agent-orchestration doc --task 
npx agent-orchestration cursor check   # Verify Cursor CLI support
npx agent-orchestration cursor delegate --task 
npx agent-orchestration cursor status --task
在 GitHub 查看完整 README

安装

npx -y agent-orchestration serve
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "agent-orchestration": { "command": "npx", "args": ["-y", "agent-orchestration", "serve"], "env": { "MCP_ORCH_SYNC_CONTEXT": "true" } } } }