Ultimate MCP Server

🚀 UMCP (Uniform Model Context Protocol)

UMCP (Uniform Model Context Protocol) is a unified model context protocol framework designed to provide a powerful, flexible, and secure environment for running and managing various intelligent tools and large language models (LLMs). Through standardized interfaces and protocols, UMCP allows developers to easily integrate multiple AI tools and services while ensuring the security and scalability of the system.

🚀 Quick Start

Installation

Quick Installation

pip install umcp

Full Dependency Management

uv sync

Environment Configuration

Edit the config.py file:

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

Running the Server

Default Mode

umcp run

SSE Mode (Recommended for Web and Remote Clients)

umcp run --sse

Custom Configuration

umcp run --config custom_config.py

✨ Features

Core Features

• Multi-model Support: Compatible with major LLM providers (e.g., OpenAI, Anthropic, Google, DeepSeek, xAI, etc.).
• Context Management: Defines the interaction mode between tools and models through a unified protocol.
• File Operations: Securely read and write files, supporting multiple file formats (e.g., Excel, JSON, CSV, etc.).
• Data Processing: Powerful data processing capabilities, including text analysis, data cleaning, and transformation.
• Network Requests: Support for HTTP/HTTPS requests to interact with external APIs and services.
• Command-line Tools: Provide a rich set of command-line tools to operate on the file system, databases, and other resources.

Security Features

• Permission Control: Strictly limit the access permissions of tools. By default, only reading and writing to specified directories are allowed.
• Input Validation: Conduct strict type checking and sanitization on all user inputs to prevent injection attacks.
• Logging: Support detailed audit logs for easy tracking of operation records.
• Dependency Management: Automatically detect and fix known vulnerabilities in third-party libraries.

🔧 Technical Details

1. Protocol Definition

UMCP standardizes the interaction mode between tools and models through a protocol. This protocol is extended from JSON-RPC 2.0 and optimized specifically for AI tools and services.

2. Tool Ecosystem

UMCP offers a rich set of built-in tools covering multiple domains such as file processing, network requests, and data processing:

• Filesystem Tools: For securely operating on the file system.
• Browser Tools: Implement browser automation through Playwright.
• SQL Tools: Interact with databases using SQLAlchemy.
• Excel Tools: Process Excel files based on OpenPyXL.
• Text Processing Tools: Support text analysis and processing (e.g., Tesseract, ripgrep, jq, etc.).

3. Security Mechanisms

UMCP enables multiple security measures by default:

• Directory Restriction: Limit the scope of file operations through the ALLOWED_DIRS configuration.
• Input Validation: All tool inputs undergo strict type checking and sanitization.
• Least Privilege Mode: Processes run as non-privileged users to prevent unauthorized operations.

📦 Tool Support

Built-in Tool List

• Filesystem Operations: Secure file reading, writing, and directory management.
• Browser Automation: Implement web page interaction through Playwright.
• Database Queries: Interact with databases using SQLAlchemy.
• Excel Processing: Process Excel files based on OpenPyXL.
• Text Analysis: Support multiple text processing tools (e.g., Tesseract, ripgrep, jq, etc.).

Third-party Integration

UMCP supports integration with the following services:

• HTTP/HTTPS API
• Cloud Storage (S3, GCS, Azure Blob Storage)
• Message Queues (RabbitMQ, Kafka)

⚠️ Important Note

Default Security Policy

• Prohibit the execution of arbitrary code.
• Limit the directory scope of file operations.
• Enable input validation and output sanitization by default.

Advanced Security Features

• Access Control: Role-based access control (RBAC).
• Audit Logging: Record all sensitive operations.
• Intrusion Detection: Monitor abnormal behaviors in real-time.

📄 License

UMCP is open-source software licensed under the MIT License. View the full license information:

cat LICENSE

🙏 Acknowledgments

Thanks to the following projects and libraries for providing technical support to UMCP:

• Playwright: A powerful browser automation tool.
• SQLAlchemy: A feature-rich ORM tool.
• OpenPyXL: An Excel file processing library.
• Tesseract: An open-source OCR engine.

For more information, please visit our official documentation or join the community discussion group.