MySQL MCP Server

基本能力

产品定位

MySQL MCP Server 是一个数据库交互服务，旨在通过MCP协议提供对MySQL数据库的访问和操作能力。

核心功能

1. 查询工具
2. read_query: 执行SELECT查询，从数据库中读取数据。
3. write_query: 执行INSERT、UPDATE或DELETE查询。
4. create_table: 在数据库中创建新表。
5. 架构工具
6. list_tables: 获取数据库中所有表的列表。
7. describe_table: 查看特定表的架构信息。

适用场景

• 在AI辅助开发环境中查询和操作数据库
• 快速探索数据库架构
• 自动化数据库操作流程
• 在Cursor IDE等开发工具中直接访问数据库

工具列表

1. read_query: 执行SELECT查询，返回查询结果。
2. write_query: 执行数据修改查询，返回受影响的行数。
3. create_table: 创建新表，返回确认信息。
4. list_tables: 列出数据库中所有表名。
5. describe_table: 显示指定表的列定义和类型。

常见问题解答

• 安全性: 该服务器允许执行任意SQL查询，应在受信任环境中运行。
• 配置: 通过.env文件或命令行参数配置数据库连接。
• 开发: 使用@mcp.tool()装饰器可以轻松添加新功能。

使用教程

使用依赖

1. Python 3.10+
2. MySQL数据库
3. 所需Python包: bash pip install "mcp[cli]>=0.1.0" "pymysql>=1.1.0" "sqlalchemy>=2.0.0" "python-dotenv>=1.0.0" "uvicorn>=0.27.0"

安装教程

1. 创建并激活conda环境: bash conda create --name mcp-demo python=3.12 conda activate mcp-demo
2. 安装依赖: bash pip install "mcp[cli]>=0.1.0" "pymysql>=1.1.0" "sqlalchemy>=2.0.0" "python-dotenv>=1.0.0" "uvicorn>=0.27.0"

调试方式

1. 启动服务器: bash python src/mysql/server.py
2. 使用MCP Inspector测试: bash npx @modelcontextprotocol/inspector uv run /Users/caicongyang/IdeaProjects/tom/mcp-demo/src/mysql/server.py
3. 在Cursor IDE中集成:
4. 启动服务器
5. 在Cursor设置中添加MCP服务器URL
6. 使用/mcp命令查询数据库

许可证

该项目遵循 MIT 开源许可条款。