🚀 MySQL MCP 服务器生成器（支持 stdio + SSE）
本项目可用于批量生成基于 MySQL 的 MCP 服务器脚本。生成的每个脚本都支持两种传输方式，为数据交互提供了更多选择：
- stdio：通过本地子进程或管道进行调用。
- SSE (HTTP)：通过
/sse端点提供远程访问，可适配 MCP Inspector。
🚀 快速开始
安装
python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux / WSL
source .venv/bin/activate
pip install -r requirements.txt
使用流程
1️⃣ 启动生成器界面
python app.py
在浏览器中打开 http://127.0.0.1:5000，按以下步骤操作：
- 输入 MySQL 连接信息，包括主机、端口、用户、密码和数据库。
- 指定输出文件名，文件名必须以
.py结尾，例如my_server.py。 - 点击 生成。生成的脚本会自动包含一个
check_database工具，可用于快速进行连通性测试。
2️⃣ 添加自定义工具
进入 “新增工具函数” 页面，为每条 SQL 查询填写相关信息：
| 字段 | 说明 |
|---|---|
| 工具函数名 | 使用 snake_case 命名规范 |
| 工具说明 | 用 1 行文字描述该工具的功能 |
| SQL 语句 | 使用 %s 作为占位符来传递参数 |
| 输出格式(可选) | 填写 Python 代码片段，使用 content.append() 来拼接返回文本 |
示例格式化代码：
for row in rows:
content.append(f"设备账号: {row['username']}")
content.append(f"IPv4: {row['user_ip4']}")
保存后，脚本会自动插入该工具函数。
3️⃣ 运行生成的服务器脚本
| 模式 | 命令 | 访问地址 |
|---|---|---|
| stdio（默认） | python my_server.py |
– |
| SSE / HTTP | python my_server.py --http |
http://127.0.0.1:8000/sse |
⚠️ 重要提示 当前
FastMCP.run()默认监听0.0.0.0:8000。若需要自定义端口，可在启动前设置环境变量，示例如下：# Windows set MCP_PORT=9110 # Linux / macOS / WSL export MCP_PORT=9110 python my_server.py --http
4️⃣ 用 MCP Inspector 测试
npx @modelcontextprotocol/inspector
- 在 Transport 选项中选择 SSE。
- 在 URL 字段填写 http://127.0.0.1:8000/sse。 连接成功后，即可在左侧看到自动发现的工具列表，并可以对这些工具进行调用。
📚 详细文档
项目结构
├── app.py # Flask GUI 生成器
├── templates/ # Jinja2 + Bootstrap 页面
├── static/ # 前端静态资源
├── requirements.txt # 依赖列表
└── README.md # 使用说明（本文件）
祝你开发顺利，能够快速批量生成 MCP Server！