node-red-mcp 0.0.2

Run MCP Model Context Protocol server with Node-RED

npm install node-red-mcp

Node-RED MCP Agent Component

Este é um componente customizável para Node-RED que permite executar agentes MCP (Model Context Protocol) através de uma interface web.

Instalação

Opção 1: Instalação Local no Node-RED

1. Copie os arquivos mcp-agent.js e mcp-agent.html para o diretório de nós do seu Node-RED
2. Reinicie o Node-RED
3. O componente "MCP Agent" aparecerá na categoria "function"

Opção 2: Instalação via npm (quando publicado)

npm install node-red-contrib-mcp-agent

Configuração

1. Servidor MCP Web Service

Primeiro, você precisa ter o servidor MCP rodando. Use o código fornecido em mcp-web-service/:

cd mcp-web-service
npm install
npm start

O servidor rodará por padrão na porta 3000.

2. Configuração do Componente

• URL do Servidor: URL onde o serviço MCP está rodando (ex: http://localhost:3000)
• Prompt Padrão: Prompt opcional que será usado se não for fornecido na mensagem
• Timeout: Tempo limite para a requisição em milissegundos (padrão: 30000)

Uso

Entradas

• msg.payload (string): O prompt a ser enviado para o agente MCP
• msg.prompt (string): Prompt específico (sobrescreve o prompt padrão)

Saídas

• msg.payload (string): A resposta do agente MCP
• msg.mcpResult (object): Objeto detalhado contendo:
  • success: Se a execução foi bem-sucedida
  • response: A resposta do agente
  • toolsUsed: Array das ferramentas utilizadas
  • messages: Histórico completo da conversa
  • originalPrompt: O prompt original enviado

Exemplo de Fluxo

[
    {
        "id": "inject1",
        "type": "inject",
        "name": "Teste MCP",
        "props": [
            {
                "p": "payload",
                "v": "exiba informações do usuário",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "x": 100,
        "y": 100,
        "wires": [["mcp1"]]
    },
    {
        "id": "mcp1",
        "type": "mcp-agent",
        "name": "Agente MCP",
        "serverUrl": "http://localhost:3000",
        "prompt": "",
        "timeout": 30000,
        "x": 300,
        "y": 100,
        "wires": [["debug1"]]
    },
    {
        "id": "debug1",
        "type": "debug",
        "name": "Resultado",
        "active": true,
        "tosidebar": true,
        "console": false,
        "tostatus": false,
        "complete": "true",
        "targetType": "full",
        "x": 500,
        "y": 100,
        "wires": []
    }
]

Funcionalidades

• ✅ Execução de prompts via agente MCP
• ✅ Configuração flexível de servidor
• ✅ Timeout configurável
• ✅ Status visual do nó (executando, sucesso, erro)
• ✅ Tratamento de erros robusto
• ✅ Suporte a prompts dinâmicos via mensagem
• ✅ Retorno detalhado com ferramentas utilizadas

Troubleshooting

Erro de Conexão

• Verifique se o servidor MCP está rodando
• Confirme a URL do servidor na configuração
• Verifique se não há firewall bloqueando a conexão

Timeout

• Aumente o valor de timeout se as operações demoram mais
• Verifique a performance do servidor MCP

Erro de Parsing

• Verifique se o servidor está retornando JSON válido
• Confirme se o servidor MCP está funcionando corretamente

Licença

MIT