mcpField
S
Servidor TESS com Suporte a MCP

Servidor TESS com Suporte a MCP

Local
github.com/diegofornalhaDeveloper Tools0Updated 83w ago
Repository

About Servidor TESS com Suporte a MCP

A Node.js and Rust/WebAssembly proxy that connects TESS with MCP.run. It is intended for developers who need HTTP endpoints to list and execute MCP tools through a session.

Key features

  1. 01HTTP health-check endpoint
  2. 02List MCP tools by session
  3. 03Execute tools with parameters
  4. 04Rust plugin compiled to WebAssembly
  5. 05Environment-based MCP credentials

Use cases

  1. 01Check whether the proxy is running
  2. 02Retrieve available tools for an MCP session
  3. 03Forward tool calls to MCP.run

MCP support

Acts as a proxy to MCP.run, exposing HTTP endpoints to list and execute MCP tools using a session ID and SSE URL.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.