MCP-Server-TESS

MCP-Server-TESS

site icon
2025.03.26 0
TypeScriptAPI 集成代理管理文件管理开发效率
MCP-Server-TESS 是一个遵循 MCP(Model Context Protocol)协议的服务器,用于与 TESS API 进行交互。该服务器提供了一系列工具,用于管理和执行 TESS 平台上的代理(agents)以及管理与之关联的文件。
View on GitHub

Overview

基本能力

产品定位

MCP-Server-TESS 是一个中间件服务器,旨在为开发者提供与 TESS API 交互的便捷方式,支持代理管理和文件操作。

核心功能

  • 列出和管理 TESS 平台上的代理
  • 执行代理并发送自定义消息
  • 管理代理关联的文件
  • 文件上传、下载和删除

适用场景

  • 开发者需要与 TESS API 进行交互的项目
  • 自动化代理管理和执行的场景
  • 需要管理 TESS 平台文件的应用程序

工具列表

  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 平台删除文件

常见问题解答

  • 需要 Node.js 18+ 和有效的 TESS API 密钥
  • 可以通过 Smithery.ai 直接安装使用
  • 支持本地安装和 Docker 部署

使用教程

使用依赖

  • Node.js 18+
  • TESS API 密钥

安装教程

通过 Smithery.ai 安装(推荐)

  1. 访问 https://smithery.ai/server/@diegofornalha/mcp-server-tess
  2. 点击"安装"
  3. 配置 TESS API 密钥

本地安装

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

配置

  1. 创建 .env 文件(基于 .env.example
  2. 添加 TESS API 密钥:
TESS_API_KEY=sua_chave_api_aqui
PORT=3000

编译

npm run build

运行

生产模式:

npm start

开发模式(自动重载):

npm run dev

Docker 使用

构建镜像:

docker build -t mcp-server-tess .

运行容器:

docker run -p 3000:3000 -e TESS_API_KEY=sua_chave_api_aqui mcp-server-tess

调试方式

健康检查:

curl http://localhost:3000/health

列出所有可用工具:

curl http://localhost:3000/capabilities

执行代理示例:

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 开源许可条款。