MCP-Server-TESS

Servidor MCP (Model Context Protocol) para integração com a API TESS.

Sobre

Este projeto implementa um servidor que segue o protocolo MCP para interagir com a API TESS. O servidor expõe ferramentas que permitem:

Listar e gerenciar agentes
Executar agentes com mensagens personalizadas
Gerenciar arquivos e suas associações com agentes
E muito mais

Requisitos

Node.js 18+
Uma chave de API da plataforma TESS

Instalação

Via Smithery.ai (Recomendado)

Você pode usar este servidor diretamente no Smithery.ai:

Acesse https://smithery.ai/server/@diegofornalha/mcp-server-tess
Clique em "Instalar"
Configure sua chave de API TESS quando solicitado
Pronto! O servidor está disponível para uso com seu LLM favorito

Instalação Local

Clone o repositório e instale as dependências:

git clone https://github.com/seu-usuario/mcp-server-tess.git
cd mcp-server-tess
npm install

Configuração

Crie um arquivo .env baseado no .env.example
Adicione sua chave de API da TESS:

TESS_API_KEY=sua_chave_api_aqui
PORT=3000

Compilação

npm run build

Execução

Para iniciar o servidor em modo de produção:

npm start

Para desenvolvimento com recarga automática:

npm run dev

Ferramentas disponíveis

O servidor expõe as seguintes ferramentas via API HTTP:

listar_agentes_tess - Lista todos os agentes disponíveis
obter_agente_tess - Obtém detalhes de um agente específico
executar_agente_tess - Executa um agente com mensagens personalizadas
listar_arquivos_agente_tess - Lista arquivos associados a um agente
vincular_arquivo_agente_tess - Vincula um arquivo a um agente
remover_arquivo_agente_tess - Remove o vínculo de um arquivo com um agente
listar_arquivos_tess - Lista todos os arquivos disponíveis
obter_arquivo_tess - Obtém detalhes de um arquivo específico
enviar_arquivo_tess - Envia um novo arquivo para a plataforma TESS
excluir_arquivo_tess - Exclui um arquivo da plataforma TESS

Uso com Docker

Para executar o servidor usando Docker:

# Construir a imagem
docker build -t mcp-server-tess .

# Executar o container
docker run -p 3000:3000 -e TESS_API_KEY=sua_chave_api_aqui mcp-server-tess

Endpoints da API

GET /health - Endpoint de verificação da saúde do servidor
GET /capabilities - Lista todas as ferramentas disponíveis com suas descrições e parâmetros
POST /tools/:toolName - Executa uma ferramenta específica (substitua :toolName pelo nome da ferramenta)

Exemplo de uso

Com Smithery.ai

Após a instalação no Smithery.ai, você pode usar o servidor com qualquer LLM compatível com MCP:

Selecione o servidor @diegofornalha/mcp-server-tess nas configurações do seu LLM
As ferramentas da API TESS ficarão disponíveis automaticamente para seu modelo

Via API HTTP

Para executar um agente:

curl -X POST http://localhost:3000/tools/executar_agente_tess \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "seu_agent_id",
    "model": "tess-ai-light",
    "messages": [
      {"role": "user", "content": "Olá, como você está?"}
    ]
  }'

Licença

MIT

Integrations