diegofornalha_mcp server tess

# 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](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:

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

## Configuração

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

```
TESS_API_KEY=sua_chave_api_aqui
PORT=3000
```

## Compilação

```bash
npm run build
```

## Execução

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

```bash
npm start
```

Para desenvolvimento com recarga automática:

```bash
npm run dev
```

## 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:

```bash
# 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:

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:

```bash
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