Agent Construct

🚀 Agent Construct

Agent Construct 是一個 Model Context Protocol (MCP) 服務器實現，它標準化了 AI 應用程序訪問工具和上下文的方式。如同《黑客帝國》中的構造體為操作員提供即時獲取裝備的接口，Agent Construct 為 AI 模型提供了標準化的訪問工具和服務數據的接口。

🚀 快速開始

前提條件

• Python 3.8 或更高版本
• pip 包管理器

安裝

1. 克隆倉庫:

   git clone https://github.com/yourusername/agent-construct.git
   cd agent-construct
   

2. 安裝依賴項:

   pip install -r requirements.txt
   

3. 設置環境變量: 在根目錄下創建一個 .env 文件，包含以下變量：

   # 服務器配置
   SERVER_HOST=localhost
   SERVER_PORT=8000
   
   # MCP 協議設置
   MCP_VERSION=1.0
   TOOL_DISCOVERY_ENABLED=true
   
   # 安全設置
   ENABLE_AUTH=false  # 生產環境啟用
   

4. 運行服務器:

   python -m mcp_server
   

✨ 主要特性

MCP 協議實現

• 完整的 MCP 兼容性：完全實現了 Model Context Protocol 規範
• 工具發現：動態工具註冊和發現機制
• 標準化通信：實現了 MCP 的通信模式以進行工具交互

服務器架構

• FastAPI 後端：高性能異步服務器實現
• 事件流式傳輸：即時更新通過 Server-Sent Events (SSE) 提供
• 模塊化設計：核心協議處理和工具實現之間的清晰分離
• 處理器系統：可擴展的請求處理器架構以支持不同的 MCP 操作
• 基於工具的速率限制：讓服務器處理配置式的工具速率限制。

開發功能

• 工具裝飾器系統：一種簡單的通過 MCP 曝露新工具的方式
• 日誌記錄與監控：全面的日誌記錄系統用於調試和監控
• 配置管理：基於環境的配置，帶有安全默認值
• 測試框架：全面的測試套件以確保協議符合性
• 友好的 Agent 框架：包含自定義客戶端或如 smolagents 等框架的實現示例。

🔧 技術細節

核心架構

mcp_server/
├── core/               # 核心 MCP 協議實現
│   ├── server.py      # 主服務器實現
│   ├── protocol.py    # MCP 協議處理器
│   └── context.py     # 上下文管理
├── handlers/          # MCP 操作處理器
│   ├── discovery.py   # 工具發現
│   ├── execution.py   # 工具執行
│   └── context.py     # 上下文操作
├── utils/            # 工具函數
│   ├── logging.py    # 日誌記錄配置
│   ├── security.py   # 安全工具
│   └── config.py     # 配置管理
└── __main__.py       # 服務器入口點

MCP 協議功能

工具發現

• 動態工具註冊系統
• 工具能力廣告
• 版本管理
• 工具元數據和文檔

上下文管理

• 高效的上下文存儲和檢索
• 上下文的加載/卸載
• 上下文的共享與隔離

其他功能

• 安全性：通過配置實現不同模型之間的資源隔離，確保每個模型只能訪問其被允許的工具和服務。
• 擴展性：支持添加新的上下文和工具，以滿足不同模型的需求。

📄 許可證

本項目在 MIT License 下許可 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

• Model Context Protocol 提供協議規範
• FastAPI 提供了優秀的網絡框架
• 開源社區中用於構建此項目的各種工具和庫