MCP-服务器-TESS

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

项目概述

该项目实现了一个遵循MCP协议的服务器，以交互 TEZZ API。该服务器公开了以下功能：

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

先决条件

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

安装

通过Smithery.ai（推荐）

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

1. 访问https://smithery.ai/server/@diegofornalha/mcp-server-tess
2. 点击“安装”
3. 当提示时配置您的TEZZ 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. 添加您的TEZZ 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 - 将新文件上传到TEZZ平台
10. excluir_arquivo_tess - 从TEZZ平台删除文件

使用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安装完成后，您可以选择服务器@diegofornalha/mcp-server-tess与您的LLM一起使用。

示例用法

以下是一个使用curl命令执行代理的示例：

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

这将执行ID为123的代理，并传递消息"Hello TEZZ"。

许可证

该项目受MIT许可证保护。