MCP Server Tess Xtp

🚀 帶MCP支持的TESS服務器

本項目是一個集成TESS（文本評估和語義服務）與MCP（多通道平臺）的代理服務器，能高效處理相關請求，為用戶提供穩定的服務。

🚀 快速開始

要求

• Node.js 18+版本
• Rust及Cargo工具鏈
• wasm32-wasi目標 (rustup target add wasm32-wasi)

配置

1. 克隆倉庫。
2. 安裝依賴項：

   npm install
   

3. 在.env文件中配置環境變量：

   PORT=3000
   MCP_API_KEY=your_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

✨ 主要特性

• 集成TESS與MCP，實現文本評估和多通道平臺的協同工作。
• 支持WebAssembly插件，提升處理性能。
• 提供豐富的API接口，方便進行健康檢查、工具查詢和執行等操作。

📦 安裝指南

環境準備

確保系統中安裝了Node.js 18+版本、Rust及Cargo工具鏈，並添加了wasm32-wasi目標。

依賴安裝

克隆倉庫後，在項目根目錄下執行npm install安裝所需依賴。

環境配置

在.env文件中配置必要的環境變量，如端口號、MCP的API密鑰和URL等。

插件構建

使用npm run build命令構建WebAssembly插件。

服務器啟動

根據需求選擇npm start或npm run dev啟動服務器。

💻 使用示例

健康檢查

curl http://localhost:3000/health

此命令用於檢查服務器是否正常運行。

列出MCP工具

curl "http://localhost:3000/api/mcp/tools?session_id=your_session_id&mcp_sse_url=https://www.mcp.run/api/sse"

通過此命令可查詢MCP工具列表。

執行MCP工具

curl -X POST -H "Content-Type: application/json" -d '{
  "tool": "工具名稱",
  "params": {
    // 工具特定的參數
  }
}' "http://localhost:3000/api/mcp/execute?session_id=your_session_id&mcp_sse_url=https://www.mcp.run/api/sse"

該命令用於執行指定的MCP工具。

📚 詳細文檔

接口文檔

健康檢查

• 請求方式：GET
• 請求路徑：/health
• 功能：檢查服務器是否正常運行

列出MCP工具

• 請求方式：GET
• 請求路徑：/api/mcp/tools
• 查詢參數：
  • session_id：MCP會話ID
  • mcp_sse_url：MCP的SSE URL
• 功能：查詢MCP工具列表

執行MCP工具

• 請求方式：POST
• 請求路徑：/api/mcp/execute
• 查詢參數：
  • session_id：MCP會話ID
  • mcp_sse_url：MCP的SSE URL
• 請求體：

  {
    "tool": "工具名稱",
    "params": {
      // 工具特定的參數
    }
  }
  

• 功能：執行指定的MCP工具

🔧 技術細節

架構設計

服務器主要由以下部分組成：

1. Node.js + Express：作為Web服務器，負責處理HTTP請求，提供穩定的網絡服務。
2. Rust/WebAssembly插件：是處理請求的核心組件，承擔主要邏輯，利用WebAssembly的高性能特性提升處理效率。
3. MCP代理：將請求轉發到mcp.run，實現與MCP平臺的交互。

開發流程

如果需要修改服務器行為，可以按照以下步驟進行：

1. 編輯src/lib.rs中的Rust代碼，對核心邏輯進行修改。
2. 使用npm run build重新編譯插件，確保修改後的代碼生效。
3. 重啟服務器，使新的配置和代碼開始運行。

日誌和監控

服務器會記錄日誌，主要用於以下情況：

• 服務器啟動時，記錄啟動信息，方便後續排查啟動問題。
• 處理過程中的錯誤，及時捕獲並記錄錯誤信息，便於快速定位和解決問題。
• API調用情況，統計和分析API的使用頻率和調用結果，為性能優化和功能改進提供依據。

📄 許可證

文檔中未提及許可證相關信息，如有需要，請聯繫項目維護者獲取。

🔒 安全

• 所有請求必須包含有效的session_id，以確保請求的合法性和安全性。
• MCP憑證通過環境變量配置，避免憑證信息硬編碼在代碼中，提高安全性。
• 開發時啟用CORS，方便跨域開發和測試，但在生產環境中需謹慎配置，防止跨域攻擊。