Mysql_mcp_server_ddz

MCP数据服务

提供方 fanzhenddz

数据服务 未标注 会话登录 社区 / 第三方 Claude DesktopClaudeCursorCodex

Mysql_mcp_server_ddz

一句话选型结论

按资料字段整理

Mysql_mcp_server_ddz 属于数据服务类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude、Cursor 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

mysqlmcpdatabase

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mysql_mcp_server_ddz当前 未标注 未标注 未标注 无 未标注
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方fanzhenddz上游标注的维护方 fanzhenddz
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

8.7 KB
来自项目仓库与上游目录的原文,未做删改

MySQL MCP Server(基于 FastMCP 的 MySQL 工具服务器)

一个基于 Model Context Protocol (MCP) 的 MySQL 服务器,使用 FastMCP 框架实现,
用于让 AI 应用(例如 Claude Desktop、支持 MCP 的 IDE 等)安全地访问和操作 MySQL 数据库。

> 定位:这是一个“给大模型用的 MySQL 工具层”,不是传统意义上的 Web API 服务。
>
> 你可以把它理解成:把 MySQL 封装成一个 MCP Server,
> 让 LLM 通过标准协议调用“列出表、查看表数据、执行 SQL”这类能力。


功能概览

  • 列出表:
  • 通过资源 mysql://tables 列出当前数据库下所有表名
  • 查看表数据:
  • 通过资源 mysql://{table}/data 读取指定表前 100 行,返回 CSV 文本
  • 执行 SQL:
  • 提供工具 execute_sql(query: str),可以执行任意 SQL(读写都可以)
  • 对 SHOW TABLES 做了专门格式处理,保持与历史版本兼容
  • 环境变量配置:
  • 所有数据库连接参数都来自环境变量,便于在本地 / 服务器 / 容器中统一管理
  • 日志完善:
  • 所有关键路径(连接、查询、错误)都有日志记录,便于调试

技术栈

  • 语言与运行环境:
  • Python 3.11+
  • MCP 框架:
  • fastmcp —— 高层 MCP Server 框架
  • 数据库驱动:
  • mysql-connector-python
  • 项目打包 / 构建:
  • pyproject.toml + hatchling
  • 测试:
  • pytest + pytest-asyncio(目前示例测试只覆盖配置和基本初始化)

安装与依赖

> 建议使用 uv 管理 Python 环境和依赖(更快、更干净)。

1. 克隆仓库```bash

git clone https://github.com/designcomputer/mysql_mcp_server.git
cd mysql_mcp_server


### 2. 安装依赖(推荐 uv)

在项目根目录执行:```bash
uv pip install -r requirements.txt

如果你希望开发 /运行测试,还可以安装开发依赖:```bash
uv pip install -r requirements-dev.txt


> 依赖的核心部分:
>
> - `fastmcp`
> - `mysql-connector-python>=9.1.0`

如果你是通过 PyPI 安装(发布包名称可能为 `mysql-mcp-server`),可以:```bash
pip install mysql-mcp-server

> 具体包名以实际发布为准,这个仓库的源码已经适配 fastmcp。
> 若仅在本地使用,可以直接 uv pip install -e . 做可编辑安装。


数据库配置(环境变量)

所有数据库连接信息都通过环境变量传入,这对本地、服务器、容器都适用。

必须配置:```bash
MYSQL_HOST=localhost # 数据库主机
MYSQL_PORT=3306 # 端口(可选,默认 3306)
MYSQL_USER=root # 数据库用户名
MYSQL_PASSWORD=123456 # 数据库密码
MYSQL_DATABASE=jspt # 要连接的数据库名


可选配置(兼容性与高级配置):```bash
MYSQL_CHARSET=utf8mb4
MYSQL_COLLATION=utf8mb4_unicode_ci
MYSQL_SQL_MODE=TRADITIONAL

> 如果缺少 MYSQL_USER / MYSQL_PASSWORD / MYSQL_DATABASE 中任意一个,
> 在启动时会直接抛出 ValueError("Missing required database configuration"),
> 这是为了避免“悄悄用错配置”。

在 Windows cmd 中可以这样设置(示例):```bat
set MYSQL_HOST=localhost
set MYSQL_PORT=3306
set MYSQL_USER=root
set MYSQL_PASSWORD=123456
set MYSQL_DATABASE=jspt


在 PowerShell 中则是:```powershell
$env:MYSQL_HOST  = "localhost"
$env:MYSQL_PORT  = "3306"
$env:MYSQL_USER  = "root"
$env:MYSQL_PASSWORD = "123456"
$env:MYSQL_DATABASE = "jspt"

启动方式

方式一:本地直接运行(开发调试)

在项目根目录,确保已安装依赖并设置好环境变量:```bash
uv run mysql_mcp_server


或使用 Python 模块方式(等价):```bash
python -m mysql_mcp_server.server

这两种方式最终都会调用包内的 main() 函数,启动 FastMCP Server,
使用 STDIO 作为传输层,供 MCP 客户端连接。

方式二:通过 uvx 命令(推荐给 MCP 客户端使用)

如果你已经把本项目安装成一个脚本(例如通过 uv pip install -e .),
那么可以直接使用:```bash
uvx mysql_mcp_server


这会调用 `pyproject.toml` 中定义的脚本入口:```toml
[project.scripts]
mysql_mcp_server = "mysql_mcp_server:main"

与 MCP 客户端集成示例

1. Claude Desktop 配置示例

在 claude_desktop_config.json 中添加:```json
{
"mcpServers": {
"mysql": {
"command": "uv",
"args": [
"--directory",
"path/to/mysql_mcp_server",
"run",
"mysql_mcp_server"
],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASSWORD": "123456",
"MYSQL_DATABASE": "jspt"
}
}
}
}


要点:

- `command` 使用 `uv`,通过 `--directory` 指向你的项目路径
- `args` 中调用 `run mysql_mcp_server`,实质上就是运行包内 `main()`
- 数据库配置通过 `env` 字段传入

### 2. VS Code MCP 插件 `mcp.json` 示例```json
{
  "servers": {
    "mysql": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mysql_mcp_server"
      ],
      "env": {
        "MYSQL_HOST": "localhost",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASSWORD": "123456",
        "MYSQL_DATABASE": "jspt"
      }
    }
  }
}

要点:

  • VS Code 端通过 STDIO 与 MCP Server 通信
  • 使用 uvx mysql_mcp_server 启动 MCP Server
  • 数据库环境变量在 env 中配置

3. 通过 Smithery 使用

本仓库中提供了 smithery.yaml,已经从 Docker 改成本地 uvx 启动:

  • smithery.yaml 中的核心片段:```yaml
    commandFunction:
    |-
    (config) => ({
    command: 'uvx',
    args: ['mysql_mcp_server'],
    env: {
    MYSQL_HOST: config.mysqlHost,
    MYSQL_PORT: String(config.mysqlPort),
    MYSQL_USER: config.mysqlUser,
    MYSQL_PASSWORD: config.mysqlPassword,
    MYSQL_DATABASE: config.mysqlDatabase,
    }
    })

这意味着:

- 在 Smithery UI 中填好 `mysqlHost/mysqlPort/...` 等配置
- Smithery 会自动调用 `uvx mysql_mcp_server`,并把这些配置注入环境变量

---

## MCP 能力说明(Resources & Tools)

核心逻辑位于 `src/mysql_mcp_server/server.py` 中:

- **资源(Resources)**:
  - `mysql://tables` → 函数 `list_tables()`
    - 返回当前数据库所有表名的列表
  - `mysql://{table}/data` → 函数 `read_table_data(table: str)`
    - 返回指定表(如 `users`)前 100 行数据,CSV 格式字符串

- **工具(Tools)**:
  - `execute_sql(query: str)`
    - 可执行任意 SQL 语句
    - 对 `SHOW TABLES` 做了专门输出格式处理
    - 对返回结果集的查询,统一转为 `header + rows` 的 CSV 文本
    - 对非查询语句(INSERT/UPDATE/DELETE 等),返回“受影响行数”说明

> 在生产环境中建议对 `execute_sql` 做一定限制(例如:只允许 SELECT),
> 以避免通过 LLM 误删 / 误改数据。

---

## 测试

目前提供了一个简单的单元测试文件:`tests/test_server.py`:

- 验证 `app` 实例是否正确创建
- 验证缺少关键环境变量时,`get_db_config` 会抛出 `ValueError`

运行测试:```bash
# 确保已安装开发依赖
uv pip install -r requirements-dev.txt

# 运行所有测试
pytest

> 当前测试不依赖真实 MySQL,适合作为“快速回归”。
> 如果你想做集成测试,可以参考原来的 conftest.py 思路,
> 启动一个测试数据库,创建临时表,再调用资源/工具进行验证。


安全建议

访问数据库本身就有一定风险,建议遵循以下原则:

  • 为 MCP Server 创建一个权限受限的专用数据库用户(不要使用 root)
  • 仅授予必要的权限(例如:只读环境只给 SELECT)
  • 对生产库要格外谨慎,可以只连从库或备份库
  • 对 execute_sql 工具在服务端做白名单 / 黑名单限制

本仓库还提供了 SECURITY.md,里面有比较详细的 MySQL 权限管理建议,
例如:如何创建只读用户、如何限制权限、如何审计访问等,建议在生产前认真阅读。


目录结构(关键部分)```text

src/
mysql_mcp_server/
init.py # 导出 app 和 main,供命令行脚本使用
server.py # FastMCP 服务器核心逻辑(大量中文注释,适合学习)

tests/
test_server.py # 基础单元测试示例

pyproject.toml # 项目配置(依赖、脚本入口等)
requirements.txt # 运行时依赖
requirements-dev.txt # 开发 / 测试依赖
smithery.yaml # Smithery 启动配置(uvx + 环境变量)
Dockerfile # 使用 Docker 部署时可选(不再强制依赖)
SECURITY.md # MySQL 权限与安全配置建议
```


常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Mysql_mcp_server_ddz 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Mysql_mcp_server_ddz 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mysql_mcp_server_ddz 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mysql_mcp_server_ddz 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Mysql_mcp_server_ddz 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mysql_mcp_server_ddz 能提供哪些能力?

资料显示能力标签包括 mysql、mcp、database、ai、server。具体工具清单以官方文档为准。

Mysql_mcp_server_ddz 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。