# easy-mcp

**Repository Path**: bytesfly/easy-mcp

## Basic Information

- **Project Name**: easy-mcp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-06
- **Last Updated**: 2025-11-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Easy MCP

Easy MCP 是一个动态 MCP (Model Context Protocol) 工具注册服务器，允许用户创建、管理和调试 MCP 工具。该项目使用 Python 3.12、FastAPI 和 Vue3 构建，提供了一个完整的工具管理系统，包括函数代码编辑、工具调试、配置管理等功能。

## 为什么

MCP (Model Context Protocol) 已经成为AI大模型领域的标准协议，它为AI模型与外部工具的交互提供了统一的接口规范。随着大模型应用场景的不断扩展，开发者需要频繁地创建、更新和管理各种MCP工具，以满足不断变化的业务需求。

然而，传统的MCP Server开发流程存在诸多痛点：

- **开发成本高**：需要从零开始构建MCP Server项目，包括服务器架构、API设计、工具注册等
- **迭代周期长**：每次需求变更都需要修改代码、重新编译、重新部署整个服务
- **运维复杂**：工具管理、版本控制、配置管理等需要额外开发
- **响应速度慢**：无法快速适应业务需求的变化，影响产品迭代和用户体验
- **开发门槛高**：需要掌握完整的MCP协议实现和服务器开发知识

这些问题严重制约了AI大模型能力的快速落地和应用创新。Easy MCP正是为解决这些痛点而生，旨在提供一种更简单、更灵活、更高效的方式来构建和管理MCP工具生态。

## 是什么

Easy MCP 是一个动态MCP工具管理平台，它彻底简化了MCP Server的开发和维护流程。

通过Easy MCP，您可以：

- **快速开发**：只需编写简单的Python函数代码，无需关心底层MCP协议实现
- **即时生效**：代码修改后立即发布，无需重启服务，实现热更新
- **可视化管理**：通过直观的Web界面管理工具、函数和配置
- **版本控制**：内置函数版本管理，支持一键回滚
- **配置灵活**：分离代码与配置，支持动态配置调整
- **依赖管理**：支持函数间依赖关系，促进代码复用
- **完整生态**：提供用户管理、审计日志、调试工具等全套功能

简而言之，Easy MCP将传统的“编码-编译-部署”流程简化为“编写-发布”两步操作，显著提升了开发效率和响应速度，让开发者能够专注于业务逻辑实现，而非底层架构搭建。

## 怎么用

Easy MCP 提供了直观的界面和简单的操作流程，让您能够快速上手并开发自己的MCP工具。下面我们将通过详细的步骤指南，帮助您了解如何使用Easy MCP的核心功能。

### 快速入门

#### 1. 启动服务

参考[快速开始](doc/快速开始.md)，启动Easy MCP服务。

#### 2. 登录系统

- 打开浏览器，访问 `http://localhost:8000`
- 使用默认管理员账户登录（用户名：`admin`，密码：`admin`）

### 导入内置工具示例

我们先通过导入内置的天气查询工具来快速体验Easy MCP的功能：

#### 1. 导入工具

- 登录后进入「工具管理」页面
- 点击右上角的「导入工具」按钮
- 在弹出的对话框中选择「天气查询工具」
- 点击「导入」按钮完成导入

导入过程会自动创建以下三个组件：

- **天气查询工具**：一个完整的MCP工具，包含名称、描述和参数定义
- **天气查询函数**：实现天气查询逻辑的Python函数代码
- **API密钥配置**：用于存储高德地图API密钥的配置项

#### 2. 配置API密钥

- 导航到「配置管理」页面
- 找到名为「高德地图API密钥」的配置项
- 点击「编辑」按钮
- 在配置值中填入您从[高德开放平台](https://lbs.amap.com/)申请的API密钥
- 点击「保存」按钮

#### 3. 调试工具

- 返回「工具管理」页面
- 找到「天气查询工具」
- 点击「调试」按钮
- 在参数输入框中填入城市名称（如「北京」）
- 点击「执行」按钮
- 查看执行结果和输出信息

#### 4. 接入Cherry Studio

现在你可以将工具集成到Cherry Studio中，实现基于MCP的工具化开发。


## 📚 更多信息

- [快速开始](doc/快速开始.md) - 快速开始部署指南
- [OpenAPI工具](doc/OpenAPITool.md) - Swagger Open API工具使用说明
- [数据库工具](doc/DatabaseTool.md) - 数据库工具使用说明
- [Http工具](doc/HttpTool.md) - Http工具使用说明
- [开发文档.md](doc/开发文档.md) - 项目开发文档
- [Docker说明.md](doc/Docker说明.md) - 完整部署文档
- [系统设计.md](doc/系统设计.md) - 系统架构设计
- [数据库设计.md](doc/数据库设计.md) - 数据库设计文档
- [接口说明.md](doc/接口说明.md) - API接口文档

*Easy MCP - 让MCP工具开发变得简单高效！*