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 引擎。

如需更多信息，请访问我们的 官方文档 或加入 社区讨论组。