WxO Agent MCP

WxO Agent MCP

Servidor MCP (Model Context Protocol) simples que invoca um único agente Watson Orchestrate remotamente. O agente é definido uma vez por meio de variáveis de ambiente ou configuração do MCP.

Use isto quando quiser um MCP leve que apenas converse com um agente — sem gerenciamento de ferramentas, sem listagem de agentes, sem fluxos. Apenas invoke_agent(message) e get_agent().

Documentação completa: DOCUMENTATION.md (inclui capturas de tela para VS Code e Langflow).
Publicação: PUBLISHING.md – procedimento para npm e MCP Registry.

Arquitetura

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

Ferramentas

Ferramenta	Descrição
invoke_agent	Envia uma mensagem ao agente Watson Orchestrate configurado. O agente responde usando suas ferramentas e LLM.
get_agent	Obtém detalhes do agente configurado (nome, descrição, ferramentas, instruções).

Configuração

Defina estas opções em .env ou na configuração do seu cliente MCP (ex.: 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)

Início Rápido

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

Verificação

# 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?"

Executa get_agent e invoke_agent para confirmar a conectividade.

Teste no VS Code

1. Abra a pasta wxo-agent-mcp no VS Code.
2. Execute npm run build.
3. .vscode/mcp.json registra o servidor MCP como wxo-agent e carrega .env.
4. Abra o Copilot Chat (Ctrl+Shift+I) e pergunte: Use invoke_agent to ask: What is the weather in Amsterdam?
   Para "o que você pode fazer", use Use invoke_agent to ask: What can you do? para evitar que o Copilot chame get_agent primeiro.
5. Ou execute npm run test:verify pelo terminal (Ctrl+`).

Consulte DOCUMENTATION.md para mais prompts e configuração.

Exemplos de perguntas: Lista completa →

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

Langflow: Adicione um componente MCP Tools, escolha STDIO, defina Command=node, Args=["/path/to/dist/index.js"] e as variáveis de ambiente. Consulte DOCUMENTATION.md.

Configuração do Cliente MCP

Instalação com um clique (Cursor Directory)

Adicionar ao Cursor — Abre a página do Cursor Directory. Após adicionar, defina WO_API_KEY, WO_INSTANCE_URL e WO_AGENT_ID nas configurações de MCP do Cursor.

Para envio em cursor.directory/mcp/new:

Campo	Valor
Cursor Deep Link	cursor://anysphere.cursor-deeplink/mcp/install?name=WxO%20Agent%20MCP&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInd4by1hZ2VudC1tY3AiXSwiZW52Ijp7IldPX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkiLCJXT19JTlNUQU5DRV9VUkwiOiJodHRwczovL3lvdXItaW5zdGFuY2Uub3JjaGVzdHJhdGUuaWJtLmNvbSIsIldPX0FHRU5UX0lEIjoieW91ci1hZ2VudC1pZCJ9fQ==
Instruções de instalação	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)

O servidor é nomeado wxo-agent. Use envFile para carregar .env:

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

Para npx (após a publicação), use "command": "npx", "args": ["-y", "wxo-agent-mcp"] e adicione env com suas credenciais.

Antigravity

Mesma configuração do Cursor. Copie examples/antigravity-mcp.json ou adicione à sua configuração de 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"
            }
        }
    }
}

Comparação com wxo-builder-mcp-server

	wxo-agent-mcp	wxo-builder-mcp-server
Propósito	Invocar um agente	Kit de desenvolvimento completo (ferramentas, agentes, conexões, fluxos)
Agente	Único WO_AGENT_ID	Múltiplos agentes, WO_AGENT_IDs
Ferramentas	invoke_agent, get_agent	Mais de 30 ferramentas (list_skills, deploy_tool, etc.)
Caso de uso	Conversar com um agente específico	Criar e gerenciar recursos do Watson Orchestrate

Links

• npm: wxo-agent-mcp
• MCP Registry: io.github.markusvankempen/wxo-agent-mcp
• GitHub: markusvankempen/wxo-agent-mcp

Licença

Apache-2.0