Repolode
提交项目
designcomputer

designcomputer/mysql_mcp_server

让 Claude 等 AI 助手通过受控工具安全地浏览和查询 MySQL 数据库的 MCP 服务器。

在 GitHub 查看官网
Star
1,408
Fork
260
未关闭 Issue
4
最近提交
10天前

这是什么？

MySQL MCP Server 实现了 Model Context Protocol（MCP），让 AI 应用能够连接 MySQL 数据库，读取表结构和数据。它不向模型开放任意数据库访问，而是提供一组固定工具：执行 SQL 查询、查看表结构、抽样读取表中数据。

本地客户端（如 Claude Desktop、Claude Code、VS Code）可通过 stdio 连接，远程部署则可使用 Streamable HTTP（SSE）。连接参数通过环境变量配置，支持 SSL/TLS 模式和 SSH 隧道访问内网数据库。未指定单一数据库时，可进入多数据库模式，访问服务器上的所有用户数据库。日志中会自动隐藏密码和 SSH 私钥。

项目还提供 explore_database 和 analyze_table 两个引导式提示，把表结构查看和数据抽样串成多步工作流。SSE 传输本身没有内置认证，暴露到本机之外时建议放在反向代理之后。

核心功能

  • 01将 MySQL 表列为资源并读取表内容
  • 02执行 SQL 查询，支持 SELECT、SHOW、DESCRIBE 及 INSERT、UPDATE、DELETE 等 DML 语句
  • 03返回列类型、是否可空、默认值和注释等表结构信息
  • 04从表中抽样最多 20 行数据
  • 05同时支持 stdio 与 SSE/HTTP 传输方式
  • 06提供 SSH 隧道、SSL/TLS 连接和多数据库模式

适用场景

  • 让 Claude 等 AI 助手直接回答关于数据库内容的问题
  • 在编写查询前快速了解陌生数据库的表结构
  • 为开发或测试环境的 MySQL 实例提供 AI 工具的读取或受限写入能力
  • 通过 SSH 跳板机访问内网 MySQL 服务器

快速上手

  1. 1

    从 PyPI 安装软件包

    pip install mysql-mcp-server
  2. 2

    在 MCP 客户端配置的 env 块中设置 MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD 和 MYSQL_DATABASE

  3. 3

    使用 Claude Code CLI 注册该服务器

    claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server

使用前须知

  • 仅支持单条 SQL 语句，不支持多语句查询。
  • SSE 传输模式没有内置身份验证，若暴露到本机之外需要使用反向代理。
  • Claude Desktop 等宿主不会加载项目的 .env 文件，因此凭据必须写入 MCP 配置中。

收录于专题

适合 Claude Code 的 MCP Server数据库 MCP ServerClaude Code 工具、技能与插件开源 AI Agent 框架与应用MCP Server 精选数据库与 SQL 工具

标签

#mysql#mcp#database#llm#sql#claude#ai-agent#ai#claude-code#mcp-server

常见问题

mysql_mcp_server 是什么？
让 Claude 等 AI 助手通过受控工具安全地浏览和查询 MySQL 数据库的 MCP 服务器。 MySQL MCP Server 实现了 Model Context Protocol（MCP），让 AI 应用能够连接 MySQL 数据库，读取表结构和数据。它不向模型开放任意数据库访问，而是提供一组固定工具：执行 SQL 查询、查看表结构、抽样读取表中数据。
mysql_mcp_server 可以免费使用吗？用的什么许可证？
mysql_mcp_server 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
mysql_mcp_server 还在维护吗？
活跃维护中。mysql_mcp_server 最近一次提交是在 2026年10月28日。
mysql_mcp_server 适合用来做什么？
让 Claude 等 AI 助手直接回答关于数据库内容的问题 在编写查询前快速了解陌生数据库的表结构 为开发或测试环境的 MySQL 实例提供 AI 工具的读取或受限写入能力 通过 SSH 跳板机访问内网 MySQL 服务器
mysql_mcp_server 怎么安装和运行？
从 PyPI 安装软件包: pip install mysql-mcp-server 在 MCP 客户端配置的 env 块中设置 MYSQL_HOST、MYSQL_USER、MYSQL_PASSWORD 和 MYSQL_DATABASE 使用 Claude Code CLI 注册该服务器: claude mcp add --transport stdio designcomputer-mysql_mcp_server uvx mysql_mcp_server
在哪里获取 mysql_mcp_server？
源代码和安装说明在 GitHub 上：https://github.com/designcomputer/mysql_mcp_server

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目