Servidor TESS com Suporte a MCP

支持 MCP 的 TESS 服务

这是一个代理服务，用于将 TESS（Text Evaluation and Semantic Services）与 MCP（Multi-Channel Platform）集成。

要求

• Node.js 18+
• Rust 和 Cargo
• wasm32-wasi target（rustup target add wasm32-wasi）

配置

1. 克隆仓库
2. 安装依赖：

   npm install
   

3. 在 .env 文件中配置环境变量：

   PORT=3000
   MCP_API_KEY=seu_mcp_api_key
   MCP_API_URL=https://www.mcp.run/api
   MCP_SSE_URL=https://www.mcp.run/api/sse
   

构建

编译 WebAssembly 插件：

npm run build

运行

启动服务：

npm start

使用热重载进行开发：

npm run dev

端点

健康检查

• GET /health
• 检查服务是否正常运行

列出 MCP 工具

• GET /api/mcp/tools
• 查询参数：
  • session_id：MCP 会话 ID
  • mcp_sse_url：MCP SSE 的 URL

执行 MCP 工具

• POST /api/mcp/execute
• 查询参数：
  • session_id：MCP 会话 ID
  • mcp_sse_url：MCP SSE 的 URL
• 请求正文：

  {
    "tool": "nome_da_ferramenta",
    "params": {
      // parâmetros específicos da ferramenta
    }
  }
  

架构

该服务由以下部分组成：

1. Node.js + Express：接收请求的 HTTP 服务
2. Rust/WebAssembly 插件：处理请求的核心逻辑
3. MCP 代理：将请求转发到 MCP.run

开发

插件代码使用 Rust 编写，并编译为 WebAssembly。Node.js 服务会加载此插件并用它处理请求。

要修改服务的行为：

1. 编辑 src/lib.rs 中的 Rust 代码
2. 使用 npm run build 重新编译插件
3. 重启服务

日志和监控

服务会记录以下日志：

• 服务启动
• 处理错误
• API 调用

安全

• 所有请求都必须包含有效的 session_id
• MCP 凭据通过环境变量配置
• 开发期间已启用 CORS

故障排除

如果遇到问题：

1. 检查插件是否已正确编译
2. 确认环境变量已配置
3. 检查服务日志
4. 确保 MCP.run 可访问