WxO Agent MCP

WxO Agent MCP

単一の Watson Orchestrate エージェントをリモートで呼び出す、シンプルな MCP（Model Context Protocol）サーバーです。エージェントは環境変数または MCP 設定で一度定義します。

1 つのエージェントとのチャットだけを行う軽量な MCP が必要な場合にご利用ください。ツール管理、エージェント一覧表示、フローはありません。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 エージェントにメッセージを送信します。エージェントはツールと LLM を使用して応答します。
get_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）を開き、次のように尋ねます：Use invoke_agent to ask: What is the weather in Amsterdam?
   「何ができますか？」と尋ねる場合は、Copilot が先に get_agent を呼び出さないように、Use invoke_agent to ask: What can you do? を使用してください。
5. または、ターミナル（Ctrl+）から npm run test:verify` を実行します。

追加のプロンプトと設定については、DOCUMENTATION.md を参照してください。

質問の例： 一覧を見る →

invoke_agent	get_agent
アムステルダムの天気はどうですか？	get_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 ディープリンク	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 です。.env を読み込むには envFile を使用します。

{
    "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
目的	1 つのエージェントを呼び出す	完全な開発ツールキット（ツール、エージェント、接続、フロー）
エージェント	単一の WO_AGENT_ID	複数のエージェント、WO_AGENT_IDs
ツール	invoke_agent、get_agent	30 以上のツール（list_skills、deploy_tool など）
用途	特定のエージェントとチャットする	Watson Orchestrate のリソースを構築・管理する

リンク

• npm： wxo-agent-mcp
• MCP レジストリ： io.github.markusvankempen/wxo-agent-mcp
• GitHub： markusvankempen/wxo-agent-mcp

ライセンス

Apache-2.0