mcp-server-tess-xtp

Servidor TESS com Suporte a MCP

Este é um servidor proxy que integra o TESS (Text Evaluation and Semantic Services) com o MCP (Multi-Channel Platform).

Requisitos

• Node.js 18+
• Rust e Cargo
• wasm32-wasi target (rustup target add wasm32-wasi)

Configuração

1. Clone o repositório
2. Instale as dependências:

   npm install
   

3. Configure as variáveis de ambiente no arquivo .env:

   PORT=3000
   MCP_API_KEY=seu_mcp_api_key
   MCP_API_URL=https://www.mcp.run/api
   MCP_SSE_URL=https://www.mcp.run/api/sse
   

Build

Para compilar o plugin WebAssembly:

npm run build

Execução

Para iniciar o servidor:

npm start

Para desenvolvimento com hot-reload:

npm run dev

Endpoints

Health Check

• GET /health
• Verifica se o servidor está funcionando

Listar Ferramentas MCP

• GET /api/mcp/tools
• Query params:
  • session_id: ID da sessão MCP
  • mcp_sse_url: URL do SSE do MCP

Executar Ferramenta MCP

• POST /api/mcp/execute
• Query params:
  • session_id: ID da sessão MCP
  • mcp_sse_url: URL do SSE do MCP
• Body:

  {
    "tool": "nome_da_ferramenta",
    "params": {
      // parâmetros específicos da ferramenta
    }
  }
  

Arquitetura

O servidor é composto por:

1. Node.js + Express: Servidor HTTP que recebe as requisições
2. Plugin Rust/WebAssembly: Lógica principal que processa as requisições
3. Proxy MCP: Encaminha requisições para o MCP.run

Desenvolvimento

O código do plugin está em Rust e é compilado para WebAssembly. O servidor Node.js carrega este plugin e o utiliza para processar as requisições.

Para modificar o comportamento do servidor:

1. Edite o código Rust em src/lib.rs
2. Recompile o plugin com npm run build
3. Reinicie o servidor

Logs e Monitoramento

O servidor registra logs para:

• Inicialização do servidor
• Erros de processamento
• Chamadas de API

Segurança

• Todas as requisições devem incluir um session_id válido
• As credenciais do MCP são configuradas via variáveis de ambiente
• CORS está habilitado para desenvolvimento

Troubleshooting

Se encontrar problemas:

1. Verifique se o plugin foi compilado corretamente
2. Confirme que as variáveis de ambiente estão configuradas
3. Verifique os logs do servidor
4. Certifique-se que o MCP.run está acessível