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:

1. Acesse https://smithery.ai/server/@diegofornalha/mcp-server-tess

2. Clique em "Instalar"

3. Configure sua chave de API TESS quando solicitado

4. Pronto! O servidor está disponível para uso com seu LLM favorito

Instalação Local

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

Configuração

1. Crie um arquivo .env baseado no .env.example

2. Adicione sua chave de API da TESS:

Compilação

Execução

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

Para desenvolvimento com recarga automática:

Ferramentas disponíveis

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

1. listar_agentes_tess - Lista todos os agentes disponíveis

2. obter_agente_tess - Obtém detalhes de um agente específico

3. executar_agente_tess - Executa um agente com mensagens personalizadas

4. listar_arquivos_agente_tess - Lista arquivos associados a um agente

5. vincular_arquivo_agente_tess - Vincula um arquivo a um agente

6. remover_arquivo_agente_tess - Remove o vínculo de um arquivo com um agente

7. listar_arquivos_tess - Lista todos os arquivos disponíveis

8. obter_arquivo_tess - Obtém detalhes de um arquivo específico

9. enviar_arquivo_tess - Envia um novo arquivo para a plataforma TESS

10. excluir_arquivo_tess - Exclui um arquivo da plataforma TESS

Uso com Docker

Para executar o servidor usando Docker:

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:

1. Selecione o servidor @diegofornalha/mcp-server-tess nas configurações do seu LLM

2. As ferramentas da API TESS ficarão disponíveis automaticamente para seu modelo

Via API HTTP

Para executar um agente:

Licença

MIT