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 分

    請在儲存庫或註冊中心條目中宣告授權條款。