Watson Orchestrate

WXO Builder MCP サーバー

バージョン 1.0.4 · 作成者 Markus van Kempen · 日付 2026-02-20

IBM Watson Orchestrate（WXO）用の MCP サーバーです。Cursor、VS Code Copilot、Claude Desktop、Antigravity、Windsurf、または WxO Builder 拡張機能から、ツール、エージェント、接続、フローを管理し、ツールを実行できます。

markusvankempen.github.io · WxO Builder 拡張機能 · CONTRIBUTING · CHANGELOG · PUBLISHING · LICENSE

アーキテクチャとデータフロー

このパッケージには二つの役割があります。

1. MCP プロトコル： MCP サーバーとして動作します。お使いの AI 環境（Cursor、Claude Desktop、VS Code Copilot、Antigravity、Windsurf など）が、接続してツールを呼び出す MCP クライアントです。
2. Watson Orchestrate： 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 に転送し、結果を返します。

関連：WxO Builder 拡張機能と MCP サーバーの組み合わせ

WxO Builder 拡張機能とこのMCP サーバーを連携させることで、IDE から Watson Orchestrate を直接作成、管理できます。ビジュアル編集には拡張機能を、AI を活用したワークフロー（Cursor、Claude Desktop など）には MCP サーバーを使用してください。

	リンク
WxO Builder 拡張機能	VS Code Marketplace
Open VSX	open-vsx.org/extension/markusvankempen/wxo-builder
作成者	markusvankempen.github.io
MCP レジストリ	registry.modelcontextprotocol.io/?q=wxo-builder-mcp-server
ソースコード	github.com/markusvankempen/wxo-builder-vscode-extension

拡張機能では、ビジュアルなツール作成、ドラッグ＆ドロップによるエージェント編集、ローカルおよびリモートでのテストができます。MCP サーバーは、同じ Watson Orchestrate の機能を Cursor、Claude Desktop、Antigravity、Windsurf、VS Code Copilot の AI アシスタントに公開します。

ディレクトリ掲載用コピー（cursor.directory など）

Cursor ディープリンク（インストールダイアログに「WxO Builder MCP Server」と表示するには、こちらを使用してください）：

cursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Builder%20MCP%20Server&config=eyJXeE8gQnVpbGRlciBNQ1AgU2VydmVyIjp7ImNvbW1hbmQiOiJucHgiLCJhcmdzIjpbIi15IiwiQG1hcmt1c3ZhbmtlbXBlbi93eG8tYnVpbGRlci1tY3Atc2VydmVyIl0sImVudiI6eyJXT19BUElfS0VZIjoieW91ci1hcGkta2V5IiwiV09fSU5TVEFOQ0VfVVJMIjoiaHR0cHM6Ly95b3VyLWluc3RhbmNlLm9yY2hlc3RyYXRlLmlibS5jb20ifX19

Cursor ディープリンクジェネレーター用の設定 JSON：

{
  "WxO Builder MCP Server": {
    "command": "npx",
    "args": ["-y", "wxo-builder-mcp-server"],
    "env": {
      "WO_API_KEY": "your-api-key",
      "WO_INSTANCE_URL": "https://your-instance.orchestrate.ibm.com",
      "WO_AGENT_IDs": "agent-id-1,agent-id-2"
    }
  }
}

WO_AGENT_IDs（カンマ区切りのリスト）またはWO_AGENT_IDが設定されている場合、ユーザーがエージェントを指定しないと、エージェントベースのツールでは最初の ID がデフォルトとして使用されます。

短い説明（100 文字以内）：

Watson Orchestrate のツール、エージェント、接続を管理します。WxO Builder 拡張機能と組み合わせてご利用ください。

詳しい説明：

Cursor、Copilot、Claude から IBM Watson Orchestrate（WXO）のツール、エージェント、接続、フローを管理します。IDE のすべての機能を利用するには、WxO Builder VS Code 拡張機能との併用をおすすめします。ビジュアルでのツール作成、ドラッグ＆ドロップによるエージェント操作、ローカル／リモートでのテストが可能です。

---

配布オプション：

• npm – wxo-builder-mcp-serverをインストールします（推奨）
• MCP Registry – registry.modelcontextprotocol.io/?q=wxo-builder-mcp-server
• スタンドアロンリポジトリ – MCP サーバーのみをクローンする場合は、github.com/markusvankempen/wxo-builder-mcp-serverを使用します
• Devkit – このパッケージはwatsonx-orchestrate-devkitのpackages/wxo-builder-mcp-serverにも含まれています（WxO Builder 拡張機能と共有）

npm からインストール

npm install wxo-builder-mcp-server

Cursor にワンクリックでインストール

Cursor に追加 — クリックしてインストールします（「WxO Builder MCP Server」と表示されます）。次に、Cursor の MCP 設定でWO_API_KEYとWO_INSTANCE_URLを設定してください。

クイックスタート

1. 環境変数を設定します（または.envを使用します）：

WO_API_KEY=<your_ibm_cloud_api_key>
WO_INSTANCE_URL=https://<your-instance-id>.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=<your-agent-id>

WO_AGENT_IDs（カンマ区切り）またはWO_AGENT_IDが設定されている場合、ユーザーがエージェントを指定しないと、ツールでは最初の ID がデフォルトとして使用されます。

2. MCP クライアントを設定します – .jsのパスを指定せずに済むよう、npxを使用してください。Cursor の設定例（.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 Code Copilot ではmcpServersの代わりにserversを使用します。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 Code／GitHub Copilot → .vscode/mcp.jsonにコピー
examples/.cursor/mcp.json	Cursor → .cursor/mcp.jsonにコピー
examples/claude-desktop-config.json	Claude Desktop → ~/Library/Application Support/Claude/claude_desktop_config.jsonに統合
examples/antigravity-mcp-config.json	Antigravity → Manage MCP Servers からmcp_config.jsonに追加
examples/windsurf-mcp-config.json	Windsurf → ~/.codeium/windsurf/mcp_config.jsonにコピー
examples/env.example	任意の環境変数用.env

詳しくはexamples/README.mdをご覧ください。

機能（VS Code 拡張機能と同等）

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からツールを作成します。（1）APIキーが必要なAPIの場合は接続を自動作成し、（2）公開API（REST Countries、Open-Meteo）の場合は認証を行いません。
• create_python_tool_from_tool_spec_json – tool-spec.jsonの内容からPythonツールを作成します。未加工のJSON文字列に加えて、python_codeとrequirementsを渡します。「このtool-spec.jsonからツールを作成して」（例：CreatingZipFileBasedonDocuments）と言われた場合に使用します。
• create_python_tool_and_upload – Pythonツールを作成し、そのアーティファクトを一度にアップロードします。tool_spec、python_code、省略可能なrequirements、python_filenameを指定します。
• create_tool_and_assign_to_agent – URLからツールを作成し、一度にエージェントに割り当てます。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• assign_tool_to_agent – ツールをエージェントに割り当てます。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• update_skill – 名前、説明、権限を更新します（作成後にバインディング／接続を編集することはできません）
• copy_skill – ツールをコピーします。コピーの名前を付けるにはnew_name（例：「MVKWeatherV2」）を使用します。接続とパラメーターは引き継がれます。名前に使用できるのは、英字、数字、アンダースコアのみです。
• execute_tool – 名前またはIDでツールを実行します。agent_idは省略可能です。省略した場合は、WO_AGENT_IDsの最初の値を使用します。

エージェント

• list_agents – すべてのエージェントを一覧表示します
• get_agent – IDまたは名前でエージェントを取得します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• get_agent_chat_starter_settings – ウェルカムメッセージとクイックプロンプトを取得します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• update_agent_chat_starter_settings – welcome_messageとquick_promptsを更新します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• list_agent_tools – エージェントに割り当てられたツールを表示名付きで一覧表示します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• create_agent – エージェントを作成します。エージェントにツールを割り当てるには、tools配列を渡します
• update_agent – エージェントを更新します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• update_agent_instructions_from_tools – 割り当てられたツールから指示を自動生成して設定します。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• invoke_agent – エージェントとチャットします。WO_AGENT_IDsが設定されている場合、agent_id／agent_nameは省略可能です。
• delete_agent – エージェントを削除します

接続

• list_connectors – 利用可能なコネクターのカタログを一覧表示します
• list_connections – 設定済みの接続を一覧表示します（スコープ：draft、live、all）
• list_active_live_connections – アクティブかつliveの接続のみを重複なしで一覧表示します（ツールは対象外）。「アクティブかつliveのすべての接続を、接続だけ一覧表示して」のような指示に使用します。
• get_connection – app_idで接続を取得します
• create_connection – 接続エントリーを作成します
• delete_connection – 接続を削除します
• configure_connection – 接続の認証情報（api_key、basic、bearer）を設定します

フロー

• list_flows、get_flow、create_flow、delete_flow

クライアントの互換性

MCP サーバーは、以下のクライアントでテスト済みで、動作します。

クライアント	設定	備考
Cursor	examples/.cursor/mcp.json	stdio、npx または node
VS Code Copilot	examples/.vscode/mcp.json	servers キーと type: "stdio" を使用
Antigravity	examples/antigravity-mcp-config.json	Manage MCP Servers から追加
Langflow	STDIO または JSON モード	DataFrame 用に出力をフラット化します。リスト取得ツールには limit/offset パラメーターがありません

Langflow： ツールの出力は、MCP Tools コンポーネントの DataFrame 検証に合格するよう、フラットな辞書（プリミティブ値のみ）のリストに正規化されます。ネストされたオブジェクト（例：binding、input_schema）は JSON 文字列に変換されます。Cursor、VS Code、Antigravity には同じ形式が渡され、同様に動作します。

検証： WO_API_KEY と WO_INSTANCE_URL を設定して npm run test:integration を実行し、コア機能を検証します。Cursor／VS Code の場合：サーバーを追加し、「Watson Orchestrate のツールを一覧表示して」または「自分が持っているエージェントは？」と尋ねます。Langflow の場合：MCP サーバーを追加し、MCP Tools を Agent に接続して、フローを実行します。

設定

以下の環境変数を設定します（または .env ファイルを使用します）。

WO_API_KEY=<your_ibm_cloud_api_key>
WO_INSTANCE_URL=https://<your-instance-id>.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 の詳細については、クイックスタートを参照してください。

トラブルシューティング

「Process exited with code 2」／「MCP server could not be started」

1. 認証情報が設定されていることを確認します – WO_API_KEY と WO_INSTANCE_URL は、MCP 設定の env ブロックまたは .env ファイルに設定する必要があります。
2. サーバーを手動で実行できることを確認します – ターミナルから実行します。

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

   起動して待機状態になります。終了するには Ctrl+C を押します。
3. Node のバージョンを確認します – Node.js 18 以降が必要です。
4. WxO Builder 拡張機能 – 拡張機能の設定で API Key と Instance URL が設定されていることを確認します（VS Code の設定で wxo-builder を検索します）。

ローカルでの実行

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

テスト質問： ライブ接続の一覧表示 | ツールのコピー | 標準ツールの一覧表示 | URL から MVKWeather を作成 | ローカル／リモートで実行 | エージェントとのチャット | 為替レート | REST Countries + 割り当て | エージェントツールの一覧表示 | tool-spec.json からツールを作成（CreatingZipFileBasedonDocuments） | エージェント会話 ZIP | ツールのアーティファクトをダウンロード

ツールをエージェントに割り当てる

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 でツールをデプロイする際、接続をバインドするには、OpenAPI 仕様に x-ibm-connection-id（または接続の 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 Code、Cursor、Claude Desktop、Antigravity、Windsurf）

重要： MCP 設定は VS Code の settings.json には記述しません。エディターに適した設定ファイルを使用してください。

VS Code（GitHub Copilot を使用）

設定ファイル：.vscode/mcp.json（ワークスペース）または、グローバル設定の場合は MCP: Open User Configuration を実行します。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

設定ファイル：.cursor/mcp.json（プロジェクト）または ~/.cursor/mcp.json（グローバル）。servers ではなく mcpServers を使用します。上記と同じ command と args を指定します。

Antigravity（Google）

Manage MCP Servers → View raw config を開き、examples/antigravity-mcp-config.json の watsonx エントリーを mcp_config.json に追加します。形式は Cursor と同じ mcpServers です。

Windsurf（Codeium）

設定ファイル：~/.codeium/windsurf/mcp_config.json（macOS/Linux）または %USERPROFILE%\.codeium\windsurf\mcp_config.json（Windows）。examples/windsurf-mcp-config.json を使用します。形式は Cursor と同じ 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 でビルドおよび実行します（.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 Registry への公開

1. MCP publisher CLI をインストールします：brew install mcp-publisher
2. ログインします：mcp-publisher login github
3. server.json のバージョンを package.json に合わせて更新します
4. 公開します：mcp-publisher publish

サーバーは registry.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 — LICENSE を参照してください。CONTRIBUTING · CHANGELOG