WxO Agent MCP

WxO Agent MCP

一个简单的 MCP（Model Context Protocol）服务，可远程调用单个 Watson Orchestrate Agent。通过环境变量或 MCP 配置定义 Agent。

当你只想用轻量级 MCP 与一个 Agent 对话，而不需要管理工具、列出 Agent 或使用流程时，可使用此服务。只需调用 invoke_agent(message) 和 get_agent()。

完整文档： DOCUMENTATION.md（包含 VS Code 和 Langflow 的截图）。
发布： PUBLISHING.md – npm 和 MCP Registry 发布流程。

架构

                    ┌───────────────────────────────────────┐
                    │  Cursor • VS Code • Langflow • etc.   │
                    │  (MCP clients)                        │
                    └──────────────────┬───────────────────┘
                                       │ stdio / JSON-RPC
                                       ▼
                    ┌───────────────────────────────────────┐
                    │  wxo-agent-mcp                        │
                    │  invoke_agent • get_agent              │
                    └──────────────────┬───────────────────┘
                                       │ HTTP / REST
                                       ▼
                    ┌───────────────────────────────────────┐
                    │  Watson Orchestrate                   │
                    │  agent + tools + LLM                   │
                    └───────────────────────────────────────┘

工具

工具	描述
invoke_agent	向配置的 Watson Orchestrate Agent 发送消息。Agent 使用其工具和大模型进行响应。
get_agent	获取已配置 Agent 的详细信息（名称、描述、工具、说明）。

配置

在 .env 或 MCP 客户端配置中设置这些变量（例如 Cursor 的 mcp.json）：

WO_API_KEY=your-ibm-cloud-api-key
WO_INSTANCE_URL=https://your-instance-id.orchestrate.ibm.com
WO_AGENT_ID=your-agent-id
# Or WO_AGENT_IDs=id1,id2  (first is used)

快速开始

npm install
npm run build
cp .env.example .env
# Edit .env with your credentials and agent ID
WO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_ID=... node dist/index.js

验证

# Default question ("Hello, who are you?")
WO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_IDs=... npm run test:verify

# Custom question
npm run test:verify -- -ask "What is the weather in Amsterdam?"

运行 get_agent 和 invoke_agent 以确认连接正常。

在 VS Code 中测试

1. 在 VS Code 中打开 wxo-agent-mcp 文件夹。
2. 运行 npm run build。
3. .vscode/mcp.json 将 MCP 服务注册为 wxo-agent，并加载 .env。
4. 打开 Copilot Chat（Ctrl+Shift+I），并询问：使用 invoke_agent 提问：阿姆斯特丹的天气如何？
   若想问“你能做什么”，请使用 使用 invoke_agent 提问：你能做什么？，以避免 Copilot 先调用 get_agent。
5. 或者在终端中运行 npm run test:verify（Ctrl+`）。

更多提示词和设置方法，请参阅 DOCUMENTATION.md。

问题示例：完整列表 →

invoke_agent	get_agent
阿姆斯特丹的天气如何？	使用 get_agent 显示 Agent 详情
给我讲个爸爸笑话	我的 Agent 有哪些工具？
东京现在几点？
你能帮我做什么？

**Langflow：**添加 MCP Tools 组件，选择 STDIO，将 Command 设置为 node，Args 设置为 ["/path/to/dist/index.js"]，并设置环境变量。请参阅 DOCUMENTATION.md。

MCP 客户端配置

一键安装（Cursor Directory）

添加到 Cursor — 打开 Cursor Directory 页面。添加后，在 Cursor MCP 设置中设置 WO_API_KEY、WO_INSTANCE_URL 和 WO_AGENT_ID。

提交至 cursor.directory/mcp/new：

字段	值
Cursor Deep Link	cursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Agent%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInd4by1hZ2VudC1tY3AiXSwiZW52Ijp7IldPX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkiLCJXT19JTlNUQU5DRV9VUkwiOiJodHRwczovL3lvdXItaW5zdGFuY2Uub3JjaGVzdHJhdGUuaWJtLmNvbSIsIldPX0FHRU5UX0lEIjoieW91ci1hZ2VudC1pZCJ9fQ==
安装说明	https://github.com/markusvankempen/wxo-agent-mcp#mcp-client-configuration

Cursor（.cursor/mcp.json）

{
    "mcpServers": {
        "wxo-agent": {
            "command": "npx",
            "args": ["-y", "wxo-agent-mcp"],
            "env": {
                "WO_API_KEY": "your-api-key",
                "WO_INSTANCE_URL": "https://xxx.orchestrate.ibm.com",
                "WO_AGENT_ID": "your-agent-id"
            }
        }
    }
}

VS Code Copilot（.vscode/mcp.json）

服务名称为 wxo-agent。使用 envFile 加载 .env：

{
    "servers": {
        "wxo-agent": {
            "type": "stdio",
            "command": "node",
            "args": ["${workspaceFolder}/dist/index.js"],
            "envFile": "${workspaceFolder}/.env"
        }
    }
}

发布后使用 npx 时，设置 "command": "npx"、"args": ["-y", "wxo-agent-mcp"]，并添加包含凭据的 env。

Antigravity

配置与 Cursor 相同。复制 examples/antigravity-mcp.json，或添加到 MCP 配置中：

{
    "mcpServers": {
        "wxo-agent": {
            "command": "npx",
            "args": ["-y", "wxo-agent-mcp"],
            "env": {
                "WO_API_KEY": "your-api-key",
                "WO_INSTANCE_URL": "https://xxx.orchestrate.ibm.com",
                "WO_AGENT_ID": "your-agent-id"
            }
        }
    }
}

与 wxo-builder-mcp-server 的比较

	wxo-agent-mcp	wxo-builder-mcp-server
用途	调用一个 Agent	完整的开发工具包（工具、Agent、连接、流程）
Agent	单个 WO_AGENT_ID	多个 Agent，WO_AGENT_IDs
工具	invoke_agent、get_agent	30 多个工具（list_skills、deploy_tool 等）
使用场景	与特定 Agent 聊天	构建和管理 Watson Orchestrate 资源

链接

• npm： wxo-agent-mcp
• MCP Registry： io.github.markusvankempen/wxo-agent-mcp
• GitHub： markusvankempen/wxo-agent-mcp

许可证

Apache-2.0