🚀 MySQL 模板样板项目

本项目是一个 MySQL 模板样板项目，为数据库操作提供了一套完整的架构和工具集，支持本地和 Docker 部署，方便开发者快速搭建和扩展数据库应用。

🚀 快速开始

本地执行

# 配置环境
cp .env.example .env

# 修改 .env 文件以符合需求

# 安装依赖项
pip install -r requirements.txt

# 启动服务器
python mysql_mcp_server/main.py run

✨ 主要特性

• 分层架构设计：采用接口层、业务逻辑层和数据访问层的分层结构，提高代码的可维护性和扩展性。
• 丰富的数据库操作工具：提供创建表、查看表结构、执行查询等多种数据库操作工具。
• 支持 Docker 部署：方便在不同环境中快速部署和运行。
• 安全可靠：通过凭证管理、强密码策略、网络访问控制和 SSL/TLS 加密等措施，保障系统安全。

📦 安装指南

使用 Docker 运行

# 构建镜像
docker build -t mysql-mcp .

# 启动容器
docker run --name mysql-mcp-container -p 5000:5000 mysql-mcp

💻 使用示例

基础用法

# 配置环境
cp .env.example .env

# 修改 .env 文件以符合需求

# 安装依赖项
pip install -r requirements.txt

# 启动服务器
python mysql_mcp_server/main.py run

高级用法

在 executors 目录中实现新工具，并在 __init__.py 中注册它们，以扩展数据库操作功能。

📚 详细文档

目录结构

以下是项目的目录结构：

MCPBoilerPlate/
├── mysql_mcp_server/           # 主应用程序目录
│   ├── executors/              # 数据库操作执行器
│   │   ├── create_table.py     # 创建表的工具
│   │   ├── desc_table.py       # 查看表结构的工具
│   │   ├── explain.py          # 提供查询执行计划的工具
│   │   ├── insert_query.py     # 执行 INSERT 查询的工具
│   │   ├── insight_starter.py  # 用于编写报告的架构验证工具
│   │   ├── invoke_viz_pro.py   # 可视化图表推荐工具
│   │   ├── select_query.py     # 执行 SELECT 查询的工具
│   │   └── show_tables.py      # 获取表列表的工具
│   ├── helper/                 # 工具模块
│   │   ├── db_conn_helper.py   # 管理数据库连接
│   │   ├── logger_helper.py    # 日志实用程序
│   │   └── tool_decorator.py   # 工具装饰器
│   └── main.py                 # 应用程序入口点
├── docker-compose.yml          # Docker Compose 配置
├── Dockerfile                  # Docker 镜像构建设置
├── requirements.txt            # 依赖项包列表
└── .env.example                # 示例环境变量文件

架构设计

分层结构

1. 接口层: MCP 服务器 (FastMCP)
2. 业务逻辑层: 处理器和执行器
3. 数据访问层: 数据库连接和查询执行

关键类和模块

• MySQLMCPServer: 主服务器类，负责初始化并运行 MCP 服务器
• DatabaseManager: 单例模式的数据库连接管理器
• 执行器: 数据库操作的集合工具
  • execute_create_table: 创建表
  • execute_desc_table: 检查表结构
  • execute_explain: 提供查询执行计划
  • execute_insert_query: 执行 INSERT 查询
  • execute_select_query: 执行 SELECT 查询
  • execute_show_tables: 获取表列表

通信流程

1. AI 模型从 MCP 服务器请求可用工具的列表。
2. 服务器返回可用工具列表。
3. AI 模型请求执行特定工具。
4. 服务器调用相应的执行器进行数据库操作。
5. 执行结果返回给 AI 模型。

扩展性和维护

添加工具

在 executors 目录中实现新工具，并在 __init__.py 中注册它们。

环境变量管理

使用环境变量管理凭证和配置，确保敏感信息不硬编码。

🔧 技术细节

通信流程

1. AI 模型从 MCP 服务器请求可用工具的列表。
2. 服务器返回可用工具列表。
3. AI 模型请求执行特定工具。
4. 服务器调用相应的执行器进行数据库操作。
5. 执行结果返回给 AI 模型。

扩展性和维护

在 executors 目录中实现新工具，并在 __init__.py 中注册它们，可实现工具的扩展。同时，使用环境变量管理凭证和配置，确保敏感信息不硬编码，方便维护。

📄 许可证

文档未提及许可证相关信息。

⚠️ 重要提示

请遵循安全考虑部分的最佳实践，以提高系统的安全性。

💡 使用建议

在添加新工具时，确保在 executors 目录中实现，并在 __init__.py 中注册，以保证工具能正常使用。