MCP-Server-TESS

用于与 TESS API 集成的 MCP (模型上下文协议) 服务器。

关于

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

• 列出和管理代理
• 使用自定义消息执行代理
• 管理文件及其与代理的关联
• 以及更多

要求

• Node.js 18+
• 来自 TESS 平台的 API 密钥

安装

通过 Smithery.ai (推荐)

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

1. 访问 https://smithery.ai/server/@diegofornalha/mcp-server-tess
2. 点击 "安装"
3. 在提示时配置您的 TESS API 密钥
4. 完成！ 该服务器可用于您喜欢的 LLM

本地安装

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

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

配置

1. 基于 .env.example 创建一个 .env 文件
2. 添加您的 TESS API 密钥：

TESS_API_KEY=sua_chave_api_aqui
PORT=3000

编译

npm run build

执行

要在生产模式下启动服务器：

npm start

要进行具有自动重新加载的开发：

npm run dev

可用工具

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

1. listar_agentes_tess - 列出所有可用的代理
2. obter_agente_tess - 获取特定代理的详细信息
3. executar_agente_tess - 使用自定义消息执行代理
4. listar_arquivos_agente_tess - 列出与代理关联的文件
5. vincular_arquivo_agente_tess - 将文件链接到代理
6. remover_arquivo_agente_tess - 删除文件与代理的链接
7. listar_arquivos_tess - 列出所有可用的文件
8. obter_arquivo_tess - 获取特定文件的详细信息
9. enviar_arquivo_tess - 将新文件发送到 TESS 平台
10. excluir_arquivo_tess - 从 TESS 平台删除文件

使用 Docker

要使用 Docker 运行服务器：

# 构建镜像
docker build -t mcp-server-tess .

# 运行容器
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 一起使用：

1. 在 LLM 的设置中选择服务器 @diegofornalha/mcp-server-tess
2. 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á?"}
    ]
  }'

许可证

MIT