Llm Gateway MCP Server

🚀 Project Introduction

This project is a powerful implementation of the Model Context Protocol (MCP), offering a series of tools to enhance interactions with Large Language Models (LLMs). By integrating functions such as file operations, network requests, database queries, and system commands, this project enables you to more efficiently leverage LLMs to solve complex problems.

✨ Features

• Multi-tool Support: It comes with a variety of built-in tools, including browser automation, Excel file processing, SQL queries, JSON handling, etc.
• Flexible Configuration: You can easily extend its functionality through simple configurations, supporting custom tools and contexts.
• Security Mechanisms: It provides strict directory access control, input validation, and logging functions to ensure security during use.
• High Performance: Built on the FastAPI framework, it guarantees efficient network responses and processing capabilities.

📦 Installation

Quick Installation

pip install umcp

Custom Installation

uv add umcp --upgrade

🔧 Configuration Options

Edit the configuration file config.py:

# Basic settings
LOG_LEVEL = "INFO"  # Available values: DEBUG, INFO, WARNING, ERROR, CRITICAL
LOG_TO_FILE = False  # Whether to output logs to a file
DEFAULT_DIR = "/path/to/default/dir"

# Tool-related configurations
ALLOWED_DIRS = [
    "/safe/path1",
    "/safe/path2"
]

BROWSERS = ["chromium", "firefox"]

# Refer to the default configuration file for other advanced options

⚠️ Security Precautions

• Input Validation: Thoroughly check all user inputs to prevent directory traversal attacks and command injection.
• Principle of Least Privilege: Run the server process as a non-privileged user and restrict access to sensitive resources.
• Log Management: Avoid logging sensitive information and regularly rotate and clean log files.

📄 License

This project is licensed under the MIT License. Please refer to the LICENSE file for details.

🙏 Acknowledgments

Thanks for the support from the following open-source projects and technology communities:

• Model Context Protocol (MCP)
• FastAPI
• Pydantic
• And the contributions of numerous other developers and communities.

🚀 Running the Server

# Default running mode
umcp run

# SSE mode (suitable for web interfaces or remote clients)
umcp run --transport-mode sse

# Run on a specified host and port
umcp run -t sse --host 0.0.0.0 --port 8080

Note: This README provides a comprehensive overview. For specific tool parameters, advanced configuration options, and detailed implementation instructions, please refer to the project source code and relevant tool documentation.