WXO Builder MCP服务器

](https://www.npmjs.com/package/wxo-builder-mcp-server) ](https://www.npmjs.com/package/wxo-builder-mcp-server) ![License](LICENSE)

版本 1.0.4 · 作者马库斯·范·肯彭 · 日期 2026-02-20

IBM Watson Orchestrate（WXO）的MCP服务器。管理工具、代理、连接、流，并从Cursor、VS Code Copilot、Claude Desktop、Antigravity、Windsurf或WxO Builder扩展中执行工具。

· WxO生成器扩展 · 贡献 · 更新日志 · 出版 · 许可证

架构和数据流

这个包裹有一个 双重角色:

MCP协议： 它作为一个 MCP服务器 --您的AI环境（Cursor、Claude Desktop、VS Code Copilot、Antigravity、Windsurf等）是MCP *客户端* 它连接到它并调用工具。
沃森编排： 它作为一个 HTTP客户端 --它向您的Watson Orchestrate实例发出REST请求。Watson Orchestrate从不连接回此进程。

┌─────────────────────────────────┐     MCP protocol      ┌──────────────────────────┐     HTTP (REST API)     ┌─────────────────────────┐
│  MCP Client                     │  ◄──────────────────► │  WXO Builder MCP Server │  ───────────────────►  │  Watson Orchestrate     │
│  (Cursor, Claude Desktop,       │     tool calls        │  (this package)          │     /v1/orchestrate/*  │  instance                │
│   Copilot, Antigravity, etc.)    │                       │                         │                        │  (your WO cloud/hosted)  │
└─────────────────────────────────┘                       └──────────────────────────┘                        └─────────────────────────┘

MCP服务器向Watson Orchestrate公开代理操作的工具。当您调用工具时（例如。 list_skills, invoke_agent)，服务器将请求转发给Watson Orchestrate API并返回结果。

从npm安装

npm install wxo-builder-mcp-server

在Cursor中单击安装

添加到光标 --点击安装（显示“WxO Builder MCP服务器”）。然后设置 WO_API_KEY 和 WO_INSTANCE_URL 在光标MCP设置中。

快速开始

设置环境变量 （或使用 .env):

WO_API_KEY=
WO_INSTANCE_URL=https://.orchestrate.ibm.com

# Optional: default agent(s) when user omits agent_id/agent_name (first is used)
WO_AGENT_IDs=agent-id-1,agent-id-2
# Or single agent (backwards compatible):
# WO_AGENT_ID=

当 WO_AGENT_IDs （逗号分隔）或 WO_AGENT_ID 设置后，当用户未指定代理时，工具将第一个ID用作默认ID。

配置您的MCP客户端 –使用 npx 所以你从不引用 .js 路径。光标示例(.cursor/mcp.json):

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

VS代码副本使用 servers 而不是 mcpServers；同样 command 和 args:

{
    "servers": {
        "watsonx": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "wxo-builder-mcp-server"],
            "env": {
                "WO_API_KEY": "...",
                "WO_INSTANCE_URL": "https://...orchestrate.ibm.com"
            }
        }
    }
}

配置示例

复制就绪示例文件位于 examples/:

文件	用于
`examples/.vscode/mcp.json`	VS代码/GitHub副本→ 复制到 `.vscode/mcp.json`
`examples/.cursor/mcp.json`	光标→ 复制到 `.cursor/mcp.json`
`examples/claude-desktop-config.json`	克劳德桌面→ 并入 `~/Library/Application Support/Claude/claude_desktop_config.json`
`examples/antigravity-mcp-config.json`	反重力→ 添加到 `mcp_config.json` 通过管理MCP服务器
`examples/windsurf-mcp-config.json`	风帆冲浪→ 复制到 `~/.codeium/windsurf/mcp_config.json`
`examples/env.example`	可选 `.env` 对于env变量

看 examples/README.md 了解详情。

特性（与VS代码扩展奇偶校验）

OpenAPI规范

watson-orchestrate-openapi.json –描述此MCP服务器使用的Watson Orchestrate REST API的OpenAPI 3.0规范（工具、代理、连接、流、运行）。使用 get_api_spec 检索它。
get_api_spec –返回OpenAPI规范（完整或摘要）。用于发现Watson Orchestrate实例支持哪些操作。

工具（技能）

list_skills –列出目录中的所有工具（默认限制为100）
list_tools_with_connections –列出按连接状态分组的工具（有连接的工具与标准工具）。 匹配扩展工具视图。 用于“列出具有活动连接的Watson Orchestrate工具”等提示。
list_standard_tools –仅列出标准工具（无连接）。返回准确的计数和列表。
get_skill –按ID获取工具
delete_skill –删除工具
deploy_skill –从OpenAPI规范集创建一个工具 openapi_spec["x-ibm-connection-id"] 到 绑定连接 到工具
deploy_tool_from_url –从URL创建工具。使用API键处理（1）个API→ 自动创建连接，（2）公共API（REST国家，Open Meteo）→ 没有身份验证。
create_python_tool_from_tool_spec_json –创建一个Python工具 tool-spec.json 内容。将原始JSON字符串加上 python_code 和 requirements.当用户说“从这个tool-spec.json创建一个工具”时使用（例如。创建基于ZipFile的文档).
create_python_tool_and_upload –创建一个Python工具，并在一个步骤中上传其工件。 tool_spec, python_code，可选 requirements, python_filename.
create_tool_and_assign_to_agent –从URL创建一个工具，并在一个步骤中分配给代理。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
assign_tool_to_agent –将工具分配给代理。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
update_skill –更新名称、描述、权限（创建后绑定/连接不可编辑）
copy_skill 复制一个工具。使用 new_name （例如“MVKWeatherV2”）为副本命名。保持连接和参数。名称：仅限字母、数字和下划线。
execute_tool –按名称或ID执行工具。 agent_id 可选；首先使用从 WO_AGENT_IDs 当省略时。

代理

list_agents –列出所有代理
get_agent 通过ID或姓名获取代理。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
get_agent_chat_starter_settings –获取欢迎信息和快速提示。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
update_agent_chat_starter_settings –更新 welcome_message 和 quick_prompts. agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
list_agent_tools –列出分配给代理的工具及其显示名称。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
create_agent 创建一个代理。通过 tools 阵列到 分配工具 给代理人
update_agent –更新代理。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
update_agent_instructions_from_tools –从指定的工具自动生成和设置指令。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
invoke_agent –与客服聊天。 agent_id/agent_name 可选，如果 WO_AGENT_IDs 已设置。
delete_agent –删除代理

连接

list_connectors –列出可用连接器目录
list_connections –列出已配置的连接（范围：草稿、实时、全部）
list_active_live_connections –仅列出已消除重复的活动和活动连接（而不是工具）。用于“列出所有活动和活动的连接，只列出连接”。
get_connection –通过app_id获取连接
create_connection –创建连接条目
delete_connection –删除连接
configure_connection –为连接设置凭据（api_key、basic、bearer）

流动

list_flows, get_flow, create_flow, delete_flow

客户端兼容性

MCP服务器经过测试，可与以下设备配合使用：

客户端	配置	注释
光标	`examples/.cursor/mcp.json`	stdio、npx或节点
VS代码副本	`examples/.vscode/mcp.json`	使用 `servers` 钥匙， `type: "stdio"`
反重力	`examples/antigravity-mcp-config.json`	通过管理MCP服务器添加
郎福	STDIO或JSON模式	DataFrame的输出扁平化；列表工具没有限制/偏移参数

郎福： 工具输出被标准化为平面字典列表（仅原始值），因此MCP工具组件的DataFrame验证通过。嵌套对象（例如。 binding, input_schema)JSON字符串化。游标、VS代码和反重力接收相同的格式，并以相同的方式工作。

验证： 跑 npm run test:integration 随着 WO_API_KEY 和 WO_INSTANCE_URL 以验证核心功能。对于Cursor/VS Code：添加服务器，询问“列出我的Watson Orchestrate工具”或“我有哪些代理？”对于Langflow：添加MCP服务器，将MCP工具连接到代理，运行流。

配置

设置这些环境变量（或使用 .env 文件）：

WO_API_KEY=
WO_INSTANCE_URL=https://.orchestrate.ibm.com

# Optional: default agent(s) when user omits agent_id/agent_name (first is used)
WO_AGENT_IDs=agent-id-1,agent-id-2

看快速开始有关详细信息，请参阅 WO_AGENT_IDs 和 WO_AGENT_ID.

故障排除

“进程退出，代码为2”/“MCP服务器无法启动”

确保设置了凭据 – WO_API_KEY 和 WO_INSTANCE_URL 必须在MCP配置中 env 块或在 .env 文件。
验证服务器是否手动运行 –从终端：

   WO_API_KEY=your-key WO_INSTANCE_URL=https://xxx.orchestrate.ibm.com npx -y wxo-builder-mcp-server

它应该开始并等待。按Ctrl+C退出。

检查节点版本 需要Node.js 18+。
WxO生成器扩展 –确保 API密钥 和 实例URL 在扩展设置（搜索 wxo-builder 在VS代码设置中）。

本地运行

npm install
npm run build
node dist/index.js

集成测试

测试套件使用以下命令验证MCP与扩展的奇偶性 用户风格测试题。参见 tests/README.md 获取完整文档。试题定义见 tests/test-questions.ts –添加新的以扩展验证。

# With WO credentials (runs all 4 tests)
WO_API_KEY=... WO_INSTANCE_URL=... npm run test:integration

# Without WO credentials (runs local execution test only)
npm run test:integration

为代理分配工具

使用 create_agent 或 update_agent 带着一个 tools 工具ID数组：

{
    "name": "My Agent",
    "description": "...",
    "model_id": "groq/openai/gpt-oss-120b",
    "instructions": "...",
    "tools": ["tool-id-1", "tool-id-2"]
}

为工具分配连接

使用以下工具部署工具时 deploy_skill，包括 x-ibm-connection-id 在OpenAPI规范（或连接的app_id）中绑定连接：

{
  "tool_spec": { "name": "my_tool", "description": "..." },
  "openapi_spec": {
    "openapi": "3.0.1",
    "info": { "title": "My Tool", "version": "1.0.0" },
    "x-ibm-connection-id": "YOUR_APP_ID",
    "paths": { ... }
  }
}

编辑器配置（VS代码、光标、克劳德桌面、反重力、Windsurf）

重要提示： MCP配置确实如此不进入VS代码 settings.json。为编辑器使用正确的配置文件。

VS代码（使用GitHub Copilot）

配置文件： .vscode/mcp.json （工作区）或运行 MCP：打开用户配置 全球。使用 npx （不需要.js路径）：

{
    "servers": {
        "watsonx": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "wxo-builder-mcp-server"],
            "env": {
                "WO_API_KEY": "...",
                "WO_INSTANCE_URL": "https://...orchestrate.ibm.com"
            }
        }
    }
}

光标

配置文件： .cursor/mcp.json （项目）或 ~/.cursor/mcp.json （全球）。用途 mcpServers （不是 servers).相同 command 和 args 如上所述。

反重力（谷歌）

打开 管理MCP服务器→ 查看原始配置 并添加 watsonx 入口从 examples/antigravity-mcp-config.json 到你的 mcp_config.json.一样 mcpServers 格式为光标。

风帆冲浪（Codeium）

配置文件： ~/.codeium/windsurf/mcp_config.json （macOS/Linux）或 %USERPROFILE%\.codeium\windsurf\mcp_config.json （Windows）。使用 examples/windsurf-mcp-config.json.一样 mcpServers 格式为光标。更改后重新启动Windsurf。

替代方案：WxO Builder扩展捆绑服务器

如果您安装了WxO Builder VSIX并希望使用其捆绑服务器（无需npm安装），请使用扩展路径：

"command": "node",
"args": ["/Users/YOUR_USERNAME/.vscode/extensions/markusvankempen.wxo-builder-0.0.6/server/dist/index.js"]

本地构建（devkit或独立仓库）

如果您克隆了devkit或独立回购，构建并运行 npx 使用包目录（no.js路径）：

cd packages/wxo-builder-mcp-server   # devkit
# or
cd wxo-builder-mcp-server            # standalone repo

npm install && npm run build

{
    "servers": {
        "watsonx": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "/path/to/wxo-builder-mcp-server"],
            "env": {
                "WO_API_KEY": "...",
                "WO_INSTANCE_URL": "https://...orchestrate.ibm.com"
            }
        }
    }
}

发布（面向维护人员）

发布到npm

从devkit或独立仓库：

cd packages/wxo-builder-mcp-server   # devkit
# or
cd .                                 # standalone repo root

npm run build
npm publish --access public

发布到MCP注册表

安装MCP发布者CLI： brew install mcp-publisher
登录： mcp-publisher login github
更新 server.json 要匹配的版本 package.json
发布： mcp-publisher publish

服务器将出现在 register.modelcontextprotocol.io 作为 io.github.markusvankempen/wxo-builder-mcp-server.

实现：TypeScript与Node.js

此MCP服务器是用 TypeScript 并编译为JavaScript。它加载了OpenAPI规范(watson-orchestrate-openapi.json)用于记录和发现。

为什么Watson Orchestrate使用TypeScript：

更大的代码库（技能、代理、连接、流、身份验证、模型）
Watson Orchestrate各种API响应的类型安全性
更易于维护和跨多个模块扩展

许可证

Apache-2.0--参见许可证. 贡献 · 更新日志

	链接
WxO生成器扩展	VS代码市场
打开VSX	open-vsx.org/extension/markusvankepen/wxo-builder
作者
MCP注册表	register.modelcontextprotocol.io/？q=wxo-builder-mcp服务器
源代码

Wxo Builder MCP Server

快速接入

详细介绍