# @benborla29/mcp-server-mysql 中文文档

规范地址：https://npmcn.com/package/%40benborla29/mcp-server-mysql/

版本：2\.0\.9
npm 元数据更新时间：2026-06-19T04:18:10.745Z
中文译文更新时间：2026-11-07T21:57:01.414Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40benborla29/mcp-server-mysql
原文对照：https://npmcn.com/package/%40benborla29/mcp-server-mysql/?lang=original
项目主页：https://github.com/benborla/mcp-server-mysql
源码仓库：https://github.com/benborla/mcp-server-mysql

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：25 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：8 个
- 首次发布：2024-12-09T16:24:23.219Z
- 最新版本发布：2026-06-19T04:18:10.644Z
- 近 30 天下载量：72587（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：30（近 12 个月 3 个）

## 中文简介

用于与 MySQL 数据库交互的 MCP 服务器, 并有写入操作支持

## 安装

```sh
npm install @benborla29/mcp-server-mysql
```

也可以使用：`pnpm add @benborla29/mcp-server-mysql`、`yarn add @benborla29/mcp-server-mysql`、`bun add @benborla29/mcp-server-mysql`

## README

## MySQL 的 MCP 服务器

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/benborla/mcp-server-mysql)](https://archestra.ai/mcp-catalog/benborla__mcp-server-mysql)

## 发起人-布卢姆

[![Bloome](https://npmcn.com/package/%40benborla29/mcp-server-mysql/assets/bloome.png)](https://bloome.im/login?ref=2x7GfeSw)

使用mcp-server-mysql让你的AI查询MySQL? [**布鲁姆**](https://bloome.im/login?ref=2x7GfeSw) 给整个团队带来, 一个AI代理IM平台, AI代理是聊天成员。 连接您的 MCP 工具, 并让代理检查计划, 运行查询, 并回答数据问题 每个人在一个线索中 。 零地本地设置,运行于地云中,网易移动.

* * *

MCP服务器允许克洛德和其他LLMs访问MySQL——检查计划,运行查询,以及可选择地写入数据,全部通过"模型上下文协议".

## 关键特性

-   **默认只读** ——通过嵌入旗来写入操作选择入
-   **Claude 代码集成** 为Anthropic的 Claude 代码 CLI 进行了优化
-   **SSH 隧道支持** ——远程数据库内置支持
-   **多数据库模式** ——通过多个数据库进行查询而未重新连接
-   **Schema 特定权限** ——每个数据库读取/写入控制
-   **PII 编辑** ——在结果中自动掩盖敏感数据
-   **远程模式** - 带有无记名证书的HTTP运输
-   **SSL/TLS 支持** ——与 mTLS 选项的加密连接

## 所需资源

-   节点.js v20+
-   MySQL 5.7+(建议8.0+)
-   具有适当权限的 MySQL 用户

## 快速安装

**Claude代码( 最简单) :**

```bash
claude mcp add mcp_server_mysql \
  -e MYSQL_HOST="127.0.0.1" \
  -e MYSQL_PORT="3306" \
  -e MYSQL_USER="root" \
  -e MYSQL_PASS="your_password" \
  -e MYSQL_DB="your_database" \
  -- npx @benborla29/mcp-server-mysql
```

**Claude 桌面/ 其他客户端 :**

```json
{
  "mcpServers": {
    "mcp_server_mysql": {
      "command": "npx",
      "args": ["-y", "@benborla29/mcp-server-mysql"],
      "env": {
        "MYSQL_HOST": "127.0.0.1",
        "MYSQL_PORT": "3306",
        "MYSQL_USER": "root",
        "MYSQL_PASS": "your_password",
        "MYSQL_DB": "your_database"
      }
    }
  }
}
```

所有写入操作默认被禁用 。 启用方式 `ALLOW_INSERT_OPERATION=true`, (中文(简体) ), `ALLOW_UPDATE_OPERATION=true`, (中文(简体) ), `ALLOW_DELETE_OPERATION=true`。 。 。 .

## 文档

-   [安装指南](https://npmcn.com/package/%40benborla29/mcp-server-mysql/docs/INSTALLATION.md) — Smithery, Cursor, Codex, Claude 代码, 本地Repo, 远程模式
-   [配置环境变量( E)](https://npmcn.com/package/%40benborla29/mcp-server-mysql/docs/CONFIGURATION.md) ——所有入围 vars,高级配置
-   [多数据库模式](https://npmcn.com/package/%40benborla29/mcp-server-mysql/README-MULTI-DB.md) 查询多个数据库
-   [PII 修改](https://npmcn.com/package/%40benborla29/mcp-server-mysql/docs/PII-REDACTION.md) 自动数据掩蔽
-   [测试](https://npmcn.com/package/%40benborla29/mcp-server-mysql/docs/TESTING.md) ——测试设置和运行
-   [解决问题](https://npmcn.com/package/%40benborla29/mcp-server-mysql/docs/TROUBLESHOOTING.md) 共同的问题和解决办法
-   [更改日志](https://npmcn.com/package/%40benborla29/mcp-server-mysql/CHANGELOG.md)

## 工具与资源

**工具 : `mysql_query`** 执行 SQL 查询 。 默认只读. 写入操作已启用 .

**资源: `mysql://tables`** 列出连接数据库的所有表格和列元数据.

## 捐款

欢迎公关 [github.com/本博拉/mcp-server-mysql 页面存档备份,存于互联网档案馆](https://github.com/benborla/mcp-server-mysql)。 。 。 .

```bash
git clone https://github.com/benborla/mcp-server-mysql.git
pnpm install
pnpm run build
pnpm test
```

[![Contributors](https://contrib.rocks/image?repo=benborla/mcp-server-mysql)](https://github.com/benborla/mcp-server-mysql/graphs/contributors)

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40benborla29/mcp-server-mysql/LICENSE) 详细情况.

## 常见问题

### @benborla29/mcp-server-mysql 是什么？

用于与 MySQL 数据库交互的 MCP 服务器, 并有写入操作支持

### 如何安装 @benborla29/mcp-server-mysql？

在项目目录运行 npm install @benborla29/mcp-server-mysql，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-server-mysql，可以用 npx mcp-server-mysql 直接运行。

### @benborla29/mcp-server-mysql 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/benborla29\_\_mcp-server-mysql 是否存在。

### @benborla29/mcp-server-mysql 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @benborla29/mcp-server-mysql 可以商用吗？

@benborla29/mcp-server-mysql 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @benborla29/mcp-server-mysql 的下载量有多少？

根据 npm 官方下载统计，@benborla29/mcp-server-mysql 在 2026/10/08 – 2026/11/06 这 30 天内被下载 72,587 次，日均约 2,420 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @benborla29/mcp-server-mysql 还在维护吗？

最新版本 2\.0\.9 发布于 2026/06/19（4 个月前）；至今共发布 30 个版本，其中过去 12 个月发布了 3 个；首次发布于 2024/12/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。