Ultimate MCP Server

🚀 UMCP（統一模型上下文協議）

UMCP（Uniform Model Context Protocol）是一個統一的模型上下文協議框架，旨在提供一個強大、靈活且安全的環境，用於運行和管理各種智能工具與大型語言模型（LLMs）。通過標準化的接口和協議，UMCP讓開發者能輕鬆集成多種AI工具和服務，同時保障系統的安全性和可擴展性。

🚀 快速開始

UMCP 為開發者提供了便捷的使用體驗，以下是快速上手的步驟：

安裝

快速安裝

pip install umcp

全量依賴管理

uv sync

環境配置

編輯 config.py 文件：

class Settings:
    DEBUG: bool = False
    LOG_LEVEL: str = "INFO"
    ALLOWED_DIRS: list[str] = ["/path/to/allowed/directory"]
    DEFAULT_WORK_DIR: str = "/tmp/umcp-workdir"

運行服務器

默認模式

umcp run

SSE 模式（推薦用於 Web 和遠程客戶端）

umcp run --sse

自定義配置

umcp run --config custom_config.py

✨ 主要特性

核心功能

• 多模型支持：兼容主流LLM提供商（如OpenAI、Anthropic、Google、DeepSeek、xAI等）。
• 上下文管理：通過統一的協議定義工具和模型之間的交互方式。
• 文件操作：安全地讀寫文件，支持多種文件格式（如Excel、JSON、CSV等）。
• 數據處理：強大的數據處理能力，包括文本分析、數據清洗和轉換。
• 網絡請求：支持HTTP/HTTPS請求，可與外部API和服務交互。
• 命令行工具：提供豐富的命令行工具來操作文件系統、數據庫和其他資源。

安全特性

• 權限控制：嚴格限制工具的訪問權限，默認情況下只允許讀取和寫入指定目錄。
• 輸入驗證：對所有用戶輸入進行嚴格的類型檢查和 sanitization，防止注入攻擊。
• 日誌記錄：支持詳細的審計日誌，便於追蹤操作記錄。
• 依賴管理：自動檢測和修復第三方庫的已知漏洞。

📚 詳細文檔

核心組件

1. 協議定義

UMCP通過標準化的協議規範工具與模型之間的交互方式。該協議基於JSON - RPC 2.0擴展而來，專門針對AI工具和服務進行了優化。

2. 工具生態系統

UMCP提供了豐富的內置工具，涵蓋文件處理、網絡請求、數據處理等多個領域：

• Filesystem Tools：用於安全地操作文件系統。
• Browser Tools：通過Playwright實現瀏覽器自動化。
• SQL Tools：使用 SQLAlchemy 進行數據庫交互。
• Excel Tools：基於 OpenPyXL 處理 Excel 文件。
• Text Processing Tools：支持文本分析和處理（如 Tesseract、ripgrep、jq 等）。

3. 安全機制

UMCP默認啟用多項安全措施：

• 目錄限制：通過 ALLOWED_DIRS 配置來限制文件操作的範圍。
• 輸入驗證：所有工具輸入均經過嚴格的類型檢查和 sanitization。
• 最小權限模式：進程以非特權用戶運行，防止越權操作。

工具支持

內置工具列表

• Filesystem Operations：安全的文件讀寫和目錄管理。
• Browser Automation：通過 Playwright 實現網頁交互。
• Database Queries：使用 SQLAlchemy 進行數據庫操作。
• Excel Processing：基於 OpenPyXL 處理 Excel 文件。
• Text Analysis：支持多種文本處理工具（如 Tesseract、ripgrep、jq 等）。

第三方集成

UMCP支持與以下服務的集成：

• HTTP/HTTPS API
• 雲存儲（S3, GCS, Azure Blob Storage）
• 消息隊列（RabbitMQ, Kafka）

安全注意事項

默認安全策略

• 禁止執行任意代碼。
• 限制文件操作的目錄範圍。
• 默認啟用輸入驗證和輸出 sanitization。

高級安全功能

• 訪問控制：基於角色的權限管理（RBAC）。
• 審計日誌：記錄所有敏感操作。
• 入侵檢測：即時監控異常行為。

📄 許可證

UMCP 是開源軟件，採用 MIT 許可證。查看完整的許可信息：

cat LICENSE

致謝

感謝以下項目和庫為 UMCP 提供了技術支持：

• Playwright：強大的瀏覽器自動化工具。
• SQLAlchemy：功能豐富的 ORM 工具。
• OpenPyXL：Excel 文件處理庫。
• Tesseract：開源 OCR 引擎。

如需更多信息，請訪問我們的 官方文檔 或加入 社區討論組。