MCP Server Tess

🚀 MCP-Server-TESS

The MCP Protocol Model Context Protocol Server is used for integration with the TESS API.

🚀 Quick Start

The MCP-Server-TESS is a server that adheres to the MCP protocol, designed to interact with the TESS API. It offers a variety of functions to manage agents and files, enabling seamless operation with the TESS platform.

✨ Features

• List and manage agents.
• Execute agents with custom messages.
• Manage files and their associations with agents.
• And many other functions.

📦 Installation

Via Smithery.ai (Recommended)

You can directly use this server on Smithery.ai:

1. Visit https://smithery.ai/server/@diegofornalha/mcp-server-tess.
2. Click "Install".
3. Configure your TESS API key when prompted.
4. Installation completed! The server is ready to use with your favorite LLM.

Local Installation

Clone the repository and install dependencies:

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

📚 Documentation

Configuration

1. Create a .env file based on .env.example.
2. Add your TESS API key:

TESS_API_KEY=sua_chave_api_aqui
PORT=3000

Compilation

npm run build

Startup

To start the server in production mode:

npm start

For automatic reloading during development:

npm run dev

Tools Provided

The server exposes the following tools via the HTTP API:

1. listar_agentes_tess - List all available agents.
2. obter_agente_tess - Get detailed information about a specific agent.
3. executar_agente_tess - Execute an agent with a custom message.
4. listar_arquivos_agente_tess - List files associated with an agent.
5. vincular_arquivo_agente_tess - Bind a file to an agent.
6. remover_arquivo_agente_tess - Unbind a file from an agent.
7. listar_arquivos_tess - List all available files.
8. obter_arquivo_tess - Get detailed information about a specific file.
9. enviar_arquivo_tess - Upload a new file to the TESS platform.
10. excluir_arquivo_tess - Delete a file from the TESS platform.

Using Docker

To run the server using Docker:

# Build the image
docker build -t mcp-server-tess .

# Run the container
docker run -p 3000:3000 -e TESS_API_KEY=sua_chave_api_aqui mcp-server-tess

API Endpoints

• GET /health - An endpoint to check the server's health status.
• GET /capabilities - List all available tools, their descriptions, and parameters.
• POST /tools/:toolName - Execute a specific tool (replace :toolName with the tool name).

💻 Usage Examples

Via Smithery.ai

After installing on Smithery.ai, you can select the server @diegofornalha/mcp-server-tess to use with your LLM.

Example Usage

Here is an example of using the curl command to execute an agent:

curl -X POST http://localhost:3000/tools/executar_agente_tess \
  -H "Content-Type: application/json" \
  -d '{"agentId": "123", "message": "Hello TESS"}'

This will execute the agent with ID 123 and pass the message "Hello TESS".

📄 License

This project is protected by the MIT License.