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
.envbaseado 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íveisobter_agente_tess- Obtém detalhes de um agente específicoexecutar_agente_tess- Executa um agente com mensagens personalizadaslistar_arquivos_agente_tess- Lista arquivos associados a um agentevincular_arquivo_agente_tess- Vincula um arquivo a um agenteremover_arquivo_agente_tess- Remove o vínculo de um arquivo com um agentelistar_arquivos_tess- Lista todos os arquivos disponíveisobter_arquivo_tess- Obtém detalhes de um arquivo específicoenviar_arquivo_tess- Envia um novo arquivo para a plataforma TESSexcluir_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 servidorGET /capabilities- Lista todas as ferramentas disponíveis com suas descrições e parâmetrosPOST /tools/:toolName- Executa uma ferramenta específica (substitua:toolNamepelo 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-tessnas 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