easy-mcp

# Easy MCP Easy MCP is a dynamic MCP (Model Context Protocol) tool registration server that allows users to create, manage, and debug MCP tools. The project is built with Python 3.12, FastAPI, and Vue3, providing a comprehensive tool management system, including function code editing, tool debugging, configuration management, and more. ## Why MCP (Model Context Protocol) has become a standard protocol in the AI large model field, providing a unified interface specification for AI models to interact with external tools. As large model application scenarios continue to expand, developers need to frequently create, update, and manage various MCP tools to meet changing business needs. However, traditional MCP Server development processes have several pain points: - **High development costs**: Requires building an MCP Server project from scratch, including server architecture, API design, and tool registration. - **Long iteration cycle**: Each requirement change requires modifying code, recompiling, and redeploying the entire service. - **Complex operations and maintenance**: Tool management, version control, and configuration management require additional development. - **Slow response speed**: Cannot quickly adapt to changes in business needs, affecting product iteration and user experience. - **High development threshold**: Requires mastering complete MCP protocol implementation and server development knowledge. These issues severely restrict the rapid landing and application innovation of AI large model capabilities. Easy MCP is designed to solve these pain points, aiming to provide a simpler, more flexible, and more efficient way to build and manage MCP tool ecosystems. ## What Easy MCP is a dynamic MCP tool management platform that thoroughly simplifies the development and maintenance process of MCP Server. With Easy MCP, you can: - **Rapid development**: Write simple Python function code without worrying about underlying MCP protocol implementation. - **Immediate effect**: Code changes take effect immediately without restarting the service, achieving hot updates. - **Visual management**: Manage tools, functions, and configurations through an intuitive web interface. - **Version control**: Built-in function version management supports one-click rollback. - **Flexible configuration**: Separate code and configuration, supporting dynamic configuration adjustments. - **Dependency management**: Supports dependency relationships between functions, promoting code reuse. - **Complete ecosystem**: Provides user management, audit logs, debugging tools, and other comprehensive functions. In short, Easy MCP simplifies the traditional "coding-compiling-deploying" process into a "writing-publishing" two-step operation, significantly improving development efficiency and response speed, allowing developers to focus on business logic implementation rather than underlying architecture construction. ## How to Use Easy MCP provides an intuitive interface and simple operation process, allowing you to quickly get started and develop your own MCP tools. Below, we will guide you through detailed steps to understand how to use Easy MCP's core functions. ### Quick Start #### 1. Start the Service Refer to [Quick Start](doc/快速开始.md) to start the Easy MCP service. #### 2. Log in to the System - Open a browser and visit `http://localhost:8000`. - Log in with the default administrator account (username: `admin`, password: `admin`). ### Import Built-in Tool Examples Let's quickly experience Easy MCP's features by importing a built-in weather query tool: #### 1. Import the Tool - After logging in, go to the "Tool Management" page. - Click the "Import Tool" button in the top right corner. - In the pop-up dialog, select "Weather Query Tool". - Click the "Import" button to complete the import. The import process will automatically create the following three components: - **Weather Query Tool**: A complete MCP tool, including name, description, and parameter definition. - **Weather Query Function**: Python function code that implements the weather query logic. - **API Key Configuration**: A configuration item for storing AMap API keys. #### 2. Configure API Key - Navigate to the "Configuration Management" page. - Find the configuration item named "AMap API Key". - Click the "Edit" button. - Enter the API key you applied for from [AMap Open Platform](https://lbs.amap.com/) in the configuration value. - Click the "Save" button. #### 3. Debug the Tool - Return to the "Tool Management" page. - Find the "Weather Query Tool". - Click the "Debug" button. - Enter a city name (e.g., "Beijing") in the parameter input box. - Click the "Execute" button. - View the execution results and output information. #### 4. Integrate with Cherry Studio Now you can integrate the tool into Cherry Studio to achieve MCP-based tool development. ## 📚 More Information - [Quick Start](doc/快速开始.md) - Quick deployment guide - [OpenAPI Tool](doc/OpenAPITool.md) - Swagger Open API tool usage instructions - [Database Tool](doc/DatabaseTool.md) - Database tool usage instructions - [Http Tool](doc/HttpTool.md) - Http tool usage instructions - [MCP Access Token](doc/MCPToken.md) - MCP endpoint authentication and access token instructions - [Development Document.md](doc/开发文档.md) - Project development document - [Docker Instructions.md](doc/Docker说明.md) - Complete deployment document - [System Design.md](doc/系统设计.md) - System architecture design - [Database Design.md](doc/数据库设计.md) - Database design document - [Interface Instructions.md](doc/接口说明.md) - API interface document *Easy MCP - Make MCP tool development simple and efficient!*