官方 MCP Server

Agent Mesh 现已提供官方 MCP Server，并保持与 CLI 行为一致。

MCP 支持无登录启动。服务端会在 list_tools 中展示全部工具；需要登录的工具在调用阶段返回 unauthorized，并附带可执行建议。

快速开始

# stdio（默认，无需全局安装）
npx -y @annals/agent-mesh mcp serve

# 已全局安装时可直接用
agent-mesh mcp serve

# 独立 bin（等价于 stdio，全局安装时可用）
agent-mesh-mcp --transport stdio

Streamable HTTP

HTTP 传输默认仅允许本机地址绑定（localhost-only）。

npx -y @annals/agent-mesh mcp serve \
  --transport http \
  --host 127.0.0.1 \
  --port 3920 \
  --path /mcp

可选 Bearer 鉴权：

npx -y @annals/agent-mesh mcp serve --transport http --bearer-token <token>

环境变量

• AGENT_MESH_TOKEN
• AGENT_MESH_MCP_BEARER_TOKEN
• AGENT_MESH_MCP_TIMEOUT_MS

Token 优先级：

1. AGENT_MESH_TOKEN
2. 本地 ~/.agent-mesh/config.json 中的 token

Tool 命名与输出结构

Tool 命名统一为：

• agent_mesh_*

统一结构化输出字段：

• ok
• source
• command
• data
• events
• pagination
• error
• auth_required
• suggestion

客户端配置片段

Claude Desktop（stdio）

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Codex（stdio）

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

Cursor（stdio）

{
  "mcpServers": {
    "agent-mesh": {
      "command": "npx",
      "args": ["-y", "@annals/agent-mesh", "mcp", "serve", "--transport", "stdio"]
    }
  }
}

通用 HTTP 客户端

{
  "mcpServers": {
    "agent-mesh-http": {
      "url": "http://127.0.0.1:3920/mcp",
      "headers": {
        "Authorization": "Bearer <your-bearer-token>"
      }
    }
  }
}