Atrax

🚀 Atrax: MCP 服務器聚合代理 v0.1.0

Atrax 是一個用於聚合多個 MCP 服務器的代理，它能將多個服務器的資源匯聚起來，並以統一接口呈現給用戶。其名字來源於漏斗網蜘蛛，形象地象徵著它將來自多個服務器的資源匯聚到一點的強大功能。

              .  .               __
             .|  |.      _____ _/  |_____________  ___  ___
             ||  ||      \__  \\   __\_  __ \__  \ \  \/  /
             \\()//       / __ \|  |  |  | \// __ \_>    <
             .={}=.      (____  /__|  |__|  (____  /__/\_ \
            / /`'\ \          \/                 \/      \/
            ` \  / '
               `'           MCP WEB PROXY v0.1.0

🚀 快速開始

# 克隆倉庫
git clone https://github.com/yourusername/atrax.git
cd atrax

# 設置開發環境
direnv allow  # 設置 Python 虛擬環境和 pre-commit
npm install

# 構建項目
npm run build

# 運行服務器（無身份驗證）
npm run serve

# 帶令牌身份驗證運行
npm run serve:auth

# 運行煙霧測試
npm run test:smoke

✨ 主要特性

• 資源聚合：結合多個服務器的資源，帶有可配置衝突解決。
• 透明代理：向客戶端呈現一個統一的 MCP 服務器界面。
• 協議符合性：嚴格遵守 MCP 協議規範。
• 模塊化設計：組件之間有清晰的職責劃分。
• 多種傳輸類型：支持 STDIO、HTTP/SSE 和 Docker 傳輸。
• 增強錯誤處理：詳細的錯誤報告，帶上下文信息。
• Web 集成：HTTP/SSE 傳輸用於瀏覽器和基於 Web 的客戶端。
• 身份驗證支持：基於令牌的身份驗證，保護服務器訪問。

📚 詳細文檔

• DEVELOPMENT.md：開發環境設置和工作流程。
• GUIDELINES.md：項目指南和編碼標準。
• MCP_SDK_INTEGRATION.md：MCP SDK 集成指南。
• HTTP_SSE_TRANSPORT.md：HTTP/SSE 傳輸實現和使用。
• TOKEN_AUTH.md：令牌身份驗證指南和使用。
• DIRENV.md：使用 direnv 進行環境管理。
• CLAUDE.md：常用命令快速參考。
• VERSION_MANAGEMENT.md：版本管理指南。

💻 使用示例

基礎用法

examples/ 目錄包含示例服務器實現：

• 內存服務器：一個簡單的 MCP 服務器，知識圖譜存儲在內存中。
• 回聲服務器：一個基本的 MCP 服務器，返回請求內容。
• HTTP 回聲服務器：使用 HTTP/SSE 傳輸進行通信的 MCP 服務器。

運行示例命令：

# 基於 STDIO 的服務器
npm run memory-server
npm run echo-server

# 基於 HTTP/SSE 的服務器
npm run http-echo-server

# 客戶端示例
npm run echo-client      # 連接到 STDIO 回聲服務器
npm run memory-client    # 連接到 STDIO 內存服務器
npm run http-echo-client # 連接到 HTTP/SSE 回聲服務器

📄 許可證

本項目採用 MIT 許可證。