MCP-服务器-TESS

MCP（模型上下文协议）服务器用于与 TESS API 集成。

在

本项目实现了一个遵循MCP协议的服务器与TESS API进行交互。该服务器公开的工具允许：

上市和管理代理
使用自定义消息运行代理
管理文件及其与代理的关联
以及更多

Related MCP server: MCP Toolkit

要求

Node.js 18+
TESS 平台 API 密钥

安装

通过 Smithery.ai（推荐）

您可以直接在 Smithery.ai 中使用此服务器：

访问https://smithery.ai/server/@diegofornalha/mcp-server-tess
点击“安装”
出现提示时配置您的 TESS API 密钥
准备好！该服务器可供您最喜欢的 LLM 使用

本地安装

克隆存储库并安装依赖项：

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

设置

根据.env.example创建.env文件
添加您的 TESS API 密钥：

TESS_API_KEY=sua_chave_api_aqui
PORT=3000

汇编

npm run build

执行

以生产模式启动服务器：

npm start

对于自动重新加载的开发：

npm run dev

可用工具

服务器通过 HTTP API 公开以下工具：

listar_agentes_tess - 列出所有可用的代理
obter_agente_tess - 获取特定代理的详细信息
executar_agente_tess - 使用自定义消息运行代理
listar_arquivos_agente_tess - 列出与代理关联的文件
vincular_arquivo_agente_tess - 将文件链接到代理
remover_arquivo_agente_tess - 删除文件和代理之间的链接
listar_arquivos_tess - 列出所有可用文件
obter_arquivo_tess - 获取特定文件的详细信息
enviar_arquivo_tess - 向 TESS 平台发送新文件
excluir_arquivo_tess - 从 TESS 平台删除文件

与 Docker 一起使用

要使用 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

API 端点

GET /health - 服务器健康检查端点
GET /capabilities - 列出所有可用工具及其描述和参数
POST /tools/:toolName - 运行特定工具（将:toolName替换为工具名称）

使用示例

使用 Smithery.ai

一旦在 Smithery.ai 上安装，您就可以将该服务器与任何与 MCP 兼容的 LLM 一起使用：

在你的 LLM 设置中选择@diegofornalha/mcp-server-tess服务器
TESS API 工具将自动适用于您的模型

通过 HTTP API

要运行代理：

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á?"}
    ]
  }'