agent-studio-mcp

AgentStudio 的 MCP Server，为 Cursor CLI 和其他 MCP 兼容环境提供 A2A（Agent-to-Agent）通信能力。

背景

在 AgentStudio 的 Claude Agent SDK 引擎中，A2A Client 作为 in-process MCP server 被直接注入到会话中。但在 Cursor CLI 引擎下，由于 Cursor CLI 是独立进程，无法使用同样的注入方式。

本项目通过创建一个独立的 stdio MCP server 来解决这个问题。它可以一次性注册到 ~/.cursor/mcp.json，为 Cursor Agent 提供调用外部 A2A Agent 的能力。

工具

discover_agents

发现当前 workspace 下可用的外部 A2A Agent（延迟加载，不暴露敏感信息）。

参数：

• workspace (string, required) - 工作区的绝对路径

返回：

• 可用 Agent 的列表（name, url, description, enabled）
• 配置文件路径

call_external_agent

调用外部 A2A 兼容 Agent，委派任务或获取信息。

参数：

• agentUrl (string, required) - 目标 A2A Agent URL
• message (string, required) - 发送给外部 Agent 的消息
• workspace (string, required) - 工作区的绝对路径（用于查找配置和 API Key）
• agentName (string, optional) - Agent 名称
• sessionId (string, optional) - 会话 ID（多轮对话）
• useTask (boolean, optional) - 使用异步任务模式

安全设计：

• API Key 仅在 MCP Server 内部使用，永远不会暴露给调用方
• 支持 allowlist 验证

配置

本 MCP Server 复用 AgentStudio 的 A2A 配置文件，查找顺序：

1. {workspace}/.a2a/config.json（直接路径）
2. ~/.cursor/projects/{hash}/.a2a/config.json（Cursor 引擎路径）
3. ~/.claude/projects/{hash}/.a2a/config.json（Claude 引擎路径）

配置文件格式

{
  "allowedAgents": [
    {
      "name": "PPT Editor",
      "url": "https://ppt-editor.example.com/a2a/agent-1",
      "apiKey": "your-api-key",
      "description": "AI 驱动的 PPT 编辑器",
      "enabled": true
    }
  ],
  "taskTimeout": 300000,
  "maxConcurrentTasks": 5
}

安装与注册

构建

cd agent-studio-mcp
npm install
npm run build

注册到 Cursor（全局一次性）

在 ~/.cursor/mcp.json 中添加：

{
  "mcpServers": {
    "agent-studio-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/agent-studio-mcp/dist/index.js"]
    }
  }
}

使用流程

1. Agent 收到需要委派的任务
2. 调用 discover_agents(workspace) 发现可用 Agent
3. 选择合适的 Agent
4. 调用 call_external_agent(agentUrl, message, workspace)
5. 获取结果并继续处理

开发

# 安装依赖
npm install

# 开发模式（watch）
npm run dev

# 构建
npm run build

# 测试运行
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js