mysql-mcp(MCP&Agent挑战赛)

ModelScopePickStar/mysql-mcp-MCP-Agent-Challenge
Hosted
5 Stars 1.3k 次浏览 摘星 更新于 2026-08-23
开发者工具

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "mysql-mcp": {
      "args": [
        "@pickstar-2002/mysql-mcp@latest"
      ],
      "command": "npx",
      "env": {
        "MYSQL_DATABASE": "mysql",
        "MYSQL_HOST": "localhost",
        "MYSQL_PASSWORD": "123456",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root"
      }
    }
  }
}

可用工具 （15 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

mysql_connect 5 个参数 需填 3 项

连接到 MySQL 数据库

必填参数：host、user、password

mysql_disconnect

断开 MySQL 数据库连接

该工具无需必填参数，直接调用即可

mysql_list_databases

列出所有数据库

该工具无需必填参数，直接调用即可

mysql_create_database 3 个参数 需填 1 项

创建数据库

必填参数：name

mysql_drop_database 1 个参数 需填 1 项

删除数据库

必填参数：name

mysql_list_tables 1 个参数

列出指定数据库的所有表

该工具无需必填参数，直接调用即可

mysql_describe_table 2 个参数 需填 1 项

查看表结构

必填参数：tableName

mysql_create_table 1 个参数 需填 1 项

创建表

必填参数：sql

mysql_drop_table 1 个参数 需填 1 项

删除表

必填参数：tableName

mysql_query 2 个参数 需填 1 项

执行 SQL 查询

必填参数：sql

mysql_insert 2 个参数 需填 2 项

插入数据到表

必填参数：tableName、data

mysql_update 3 个参数 需填 3 项

更新表数据

必填参数：tableName、data、where

mysql_delete 2 个参数 需填 2 项

删除表数据

必填参数：tableName、where

mysql_export_data 4 个参数 需填 3 项

导出表数据到文件

必填参数：tableName、filePath、format

mysql_import_data 4 个参数 需填 3 项

从文件导入数据到表

必填参数：tableName、filePath、format

服务介绍

🚀 MySQL MCP 服务器

npm version

Node.js Version
TypeScript

🎯 强大的 MCP 工具，让 AI 助手轻松管理 MySQL 数据库

基于 Model Context Protocol (MCP) 的 MySQL 数据库管理工具，让您能够通过 AI 助手（如 Claude）执行各种数据库操作，无需手动编写 SQL 语句。

✨ 功能特性

🔗 连接管理

  • ✅ 灵活的数据库连接配置
  • ✅ 支持环境变量和参数配置
  • ✅ 连接状态检查和管理
  • ✅ 安全的连接池管理

🗄️ 数据库操作

  • ✅ 列出所有数据库
  • ✅ 创建数据库（支持字符集和排序规则）
  • ✅ 删除数据库
  • ✅ 数据库信息查询

📊 表操作

  • ✅ 列出指定数据库的所有表
  • ✅ 查看表结构和字段详情
  • ✅ 创建表（通过 SQL 语句）
  • ✅ 删除表
  • ✅ 表信息统计

📝 数据操作

  • ✅ 执行 SQL 查询（支持参数化查询）
  • ✅ 插入数据（支持批量插入）
  • ✅ 更新数据
  • ✅ 删除数据
  • ✅ 数据导出到 CSV/JSON 文件
  • ✅ 从 CSV/JSON 文件导入数据

🛡️ 安全特性

  • ✅ SQL 注入防护
  • ✅ 危险操作检测
  • ✅ 参数化查询支持
  • ✅ 权限控制建议

📦 安装

方式一：直接使用（推荐）

在您的 MCP 客户端配置中直接使用 @latest 标签：

json
{
"mcpServers": {
"mysql-mcp": {
"command": "npx",
"args": ["@pickstar-2002/mysql-mcp@latest"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "mysql"
}
}
}
}

方式二：全局安装

bash
npm install -g @pickstar-2002/mysql-mcp@latest

方式三：项目安装

bash
npm install @pickstar-2002/mysql-mcp@latest

🚀 快速开始

1. 配置环境变量

创建 .env 文件：

env
MYSQL_HOST=localhost
MYSQL_PORT=3306
MYSQL_USER=root
MYSQL_PASSWORD=your_password
MYSQL_DATABASE=mysql

可选配置

MYSQL_CONNECTION_LIMIT=10
MYSQL_TIMEOUT=60000

2. 在 Claude Desktop 中配置

编辑 Claude Desktop 配置文件：

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

json
{
"mcpServers": {
"mysql-mcp": {
"command": "npx",
"args": ["@pickstar-2002/mysql-mcp@latest"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "your_password",
"MYSQL_DATABASE": "mysql"
}
}
}
}

3. 在其他 MCP 客户端中配置

对于支持 MCP 协议的其他客户端：

json
{
"command": "npx",
"args": ["@pickstar-2002/mysql-mcp@latest"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "your_password"
}
}

💡 使用示例

配置完成后，您可以在 AI 助手中使用自然语言进行数据库操作：

🔗 连接数据库

请连接到我的 MySQL 数据库，主机是 localhost，用户名是 root

📋 查看数据库列表

请列出所有的数据库

🆕 创建数据库

请创建一个名为 test_db 的数据库，使用 utf8mb4 字符集

🔍 查看表结构

请查看 users 表的结构和字段信息

📊 执行查询

请查询 users 表中所有年龄大于 18 的用户，按注册时间排序### ➕ 插入数据
sql
请向 users 表插入一条新记录：name='张三', age=25, email='zhangsan@example.com'

📤 导出数据

sql
请将 users 表的数据导出为 CSV 文件到 /tmp/users.csv

📥 导入数据

sql
请从 /tmp/users.csv 文件导入数据到 users 表

🛠️ API 工具列表

工具名称 功能描述
mysql_connect 连接到 MySQL 数据库
mysql_disconnect 断开数据库连接
mysql_list_databases 列出所有数据库
mysql_create_database 创建数据库
mysql_drop_database 删除数据库
mysql_list_tables 列出表
mysql_describe_table 查看表结构
mysql_create_table 创建表
mysql_drop_table 删除表
mysql_query 执行 SQL 查询
mysql_insert 插入数据
mysql_update 更新数据
mysql_delete 删除数据
mysql_export_data 导出数据
mysql_import_data 导入数据

🔧 配置选项

环境变量

变量名 描述 默认值 必需
MYSQL_HOST MySQL 服务器地址 localhost ✅
MYSQL_PORT MySQL 端口号 3306 ❌
MYSQL_USER 用户名 root ✅
MYSQL_PASSWORD 密码 - ✅
MYSQL_DATABASE 默认数据库 - ❌
MYSQL_CONNECTION_LIMIT 连接池大小 10 ❌
MYSQL_TIMEOUT 连接超时时间(ms) 60000 ❌

🛡️ 安全注意事项

  1. 🔐 密码保护: 确保 .env 文件不被提交到版本控制系统
  2. 🚫 SQL 注入防护: 工具内置基础 SQL 安全检查，建议使用参数化查询
  3. 👤 权限控制: 建议为 MCP 服务器创建专用 MySQL 用户并限制权限
  4. 🌐 网络安全: 生产环境中确保 MySQL 服务器网络访问安全
  5. 📝 操作审计: 重要操作前会进行安全提示

🤝 贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 本项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

📄 许可证

本项目基于 MIT License 开源协议。

📞 联系方式

如有问题或建议，欢迎联系：

微信: pickstar_loveXX

⭐ 如果这个项目对您有帮助，请给个 Star 支持一下！

查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。