WxO Agent MCP

io.github.markusvankempen由 GitHub 账号 markusvankempen 发布v1.0.8更新于 Oct 24, 2026

Invoke a Watson Orchestrate agent via MCP. Configure with WO_AGENT_ID.

已验证STDIO仅桌面效率与工作流AI 与机器学习

概览

AI 生成的概览

让助手向一个预先配置好的 IBM Watson Orchestrate 代理发送消息，并读取该代理的详细信息。

可以做什么
这是一个轻量的本地 MCP 服务器，通过 HTTP/REST 连接单个 Watson Orchestrate 代理。它提供两个工具：invoke_agent 向已配置的代理发送消息并返回其回复，get_agent 返回代理的名称、描述、工具和指令。代理通过环境变量一次性固定，因此不提供代理列表、工具管理或流程处理。
适用场景
当你希望助手只与某个特定的 Watson Orchestrate 代理对话时使用。它适合简单的问答或查询代理详情，而不是构建和管理 Watson Orchestrate 资源；README 指出这类需求应使用另一个构建器服务器。
运行要求
通过 stdio 在本地运行，通常使用 npm 包 wxo-agent-mcp 的 npx 或本地构建副本，因此需要 Node.js。需要 IBM Cloud API 密钥（WO_API_KEY）、Watson Orchestrate 实例 URL（WO_INSTANCE_URL）以及代理 ID（WO_AGENT_ID，或 WO_AGENT_IDs，取第一个）。需要能访问该 Watson Orchestrate 实例的网络。
安装前请注意
服务器需要以 WO_API_KEY 提供的 IBM Cloud API 密钥，这属于凭据，应避免写入共享配置文件。通过 invoke_agent 发送的消息会转发到远程 Watson Orchestrate 代理并在那里处理，因此所提内容会离开本机。该代理可能调用自身的工具和 LLM，回复及由此产生的操作取决于该代理的配置。

安装

在 SourceWeft 中

  1. 打开 控制台中的 WxO Agent MCP，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

WxO Agent MCP

[npm version] [npm downloads] [License]

[wxo-agent-mcp]

[Add MCP server to Cursor]

Simple MCP (Model Context Protocol) server that invokes a single Watson Orchestrate agent remotely. The agent is defined once via environment variables or MCP config.

Use this when you want a lightweight MCP that only chats with one agent—no tool management, no agent listing, no flows. Just invoke_agent(message) and get_agent().

Full documentation: DOCUMENTATION.md (includes screenshots for VS Code and Langflow).
Publishing: PUBLISHING.md – npm and MCP Registry procedure.

Architecture

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

Tools

ToolDescription
invoke_agentSend a message to the configured Watson Orchestrate agent. The agent responds using its tools and LLM.
get_agentGet details of the configured agent (name, description, tools, instructions).

Configuration

Set these in .env or your MCP client config (e.g. Cursor mcp.json):

env
WO_API_KEY=your-ibm-cloud-api-keyWO_INSTANCE_URL=https://your-instance-id.orchestrate.ibm.comWO_AGENT_ID=your-agent-id# Or WO_AGENT_IDs=id1,id2  (first is used)

Quick Start

bash
npm installnpm run buildcp .env.example .env# Edit .env with your credentials and agent IDWO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_ID=... node dist/index.js

Verify

bash
# Default question ("Hello, who are you?")WO_API_KEY=... WO_INSTANCE_URL=... WO_AGENT_IDs=... npm run test:verify
# Custom questionnpm run test:verify -- -ask "What is the weather in Amsterdam?"

Runs get_agent and invoke_agent to confirm connectivity.

Test in VS Code

  1. Open the wxo-agent-mcp folder in VS Code.
  2. Run npm run build.
  3. .vscode/mcp.json registers the MCP server as wxo-agent and loads .env.
  4. Open Copilot Chat (Ctrl+Shift+I) and ask: Use invoke_agent to ask: What is the weather in Amsterdam?
    For "what can you do", use Use invoke_agent to ask: What can you do? to avoid Copilot calling get_agent first.
  5. Or run npm run test:verify from the terminal (Ctrl+`).

See DOCUMENTATION.md for more prompts and setup.

Question examples: Full list →

invoke_agentget_agent
What is the weather in Amsterdam?Use get_agent to show agent details
Tell me a dad jokeWhat tools does my agent have?
What time is it in Tokyo?
What can you help me with?

Langflow: Add an MCP Tools component, choose STDIO, set Command=node, Args=["/path/to/dist/index.js"], and env vars. See DOCUMENTATION.md.

MCP Client Configuration

One-click install (Cursor Directory)

Add to Cursor — Opens the Cursor Directory page. After adding, set WO_API_KEY, WO_INSTANCE_URL, and WO_AGENT_ID in Cursor MCP settings.

For cursor.directory/mcp/new submission:

FieldValue
Cursor Deep Linkcursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Agent%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInd4by1hZ2VudC1tY3AiXSwiZW52Ijp7IldPX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkiLCJXT19JTlNUQU5DRV9VUkwiOiJodHRwczovL3lvdXItaW5zdGFuY2Uub3JjaGVzdHJhdGUuaWJtLmNvbSIsIldPX0FHRU5UX0lEIjoieW91ci1hZ2VudC1pZCJ9fQ==
Install instructionshttps://github.com/markusvankempen/wxo-agent-mcp#mcp-client-configuration

Cursor (.cursor/mcp.json)

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)

The server is named wxo-agent. Use envFile to load .env:

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

For npx (after publishing), use "command": "npx", "args": ["-y", "wxo-agent-mcp"], and add env with your credentials.

Antigravity

Same config as Cursor. Copy examples/antigravity-mcp.json or add to your MCP config:

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 wxo-builder-mcp-server

wxo-agent-mcpwxo-builder-mcp-server
PurposeInvoke one agentFull dev toolkit (tools, agents, connections, flows)
AgentSingle WO_AGENT_IDMultiple agents, WO_AGENT_IDs
Toolsinvoke_agent, get_agent30+ tools (list_skills, deploy_tool, etc.)
Use caseChat with a specific agentBuild and manage Watson Orchestrate resources

Links

License

Apache-2.0

来源：README.md，提交 296ff0b

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.8最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。