Diegofornalha MCP Server Tess

🚀 MCP-Server-TESS Server

This project implements a server based on the MCP protocol for integration with the TESS API. It offers a range of functions to streamline operations and enhance user experience.

🚀 Quick Start

This server based on the MCP protocol is designed for seamless integration with the TESS API. It comes packed with features such as agent listing and management, execution of agents with custom messages, file management, and more.

✨ Features

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

📦 Installation

Recommended: Install via Smithery.ai

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 complete! The server is ready for use with your favorite LLM.

Local Installation

Clone the repository and install the 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

Start the server in production mode:

npm start

Start in development mode (with automatic hot reloading):

npm run dev

Tools Provided

The server provides 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 all 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 files.
8. obter_arquivo_tess - Get information about a specific file.
9. criar_arquivo_tess - Create a new file.
10. atualizar_arquivo_tess - Update an existing file.
11. excluir_arquivo_tess - Delete a file.

Docker Usage

How to run the server using Docker:

• First, push the project files to your Docker repository.
• Pull the image: docker pull username/mcp-server-tess:latest.
• Run the container: docker run -p 3000:3000 --env TESS_API_KEY=your_api_key_here username/mcp-server-tess.

API Endpoints

The main HTTP request methods and corresponding URL paths are as follows:

• Get all agents:
  • Request method: GET
  • URL path: /api/agentes
• Get a specific agent:
  • Request method: GET
  • URL path: /api/agentes/{id}
• Create a new agent:
  • Request method: POST
  • URL path: /api/agentes
• Update an existing agent:
  • Request method: PUT
  • URL path: /api/agentes/{id}
• Delete an agent:
  • Request method: DELETE
  • URL path: /api/agentes/{id}

System Requirements

• Node.js version 18+
• An API key for the TESS platform

⚠️ Important Note

1. Ensure that the Node.js version meets the requirements (18+).
2. The API key must be correctly configured to ensure secure communication with the TESS platform.
3. In a production environment, it is recommended to use a reverse proxy and an SSL certificate to enhance security.