db MCP (Wannanbigpig)

MCP数据服务

提供方 wannanbigpig

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeCursor

一个面向Model Context Protocol的数据库MCP Server,支持预配置连接、运行时保护、连接状态观测和分级安全模式,适用于AI安全连接MySQL、Redis、MongoDB。

一句话选型结论

按资料字段整理

db MCP (Wannanbigpig) 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

支持客户端

适用场景

数据库安全TypeScript本地部署AI连接多数据库支持运行时保护可观测性

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 34 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

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

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

数据同步与清洗

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

报表取数

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

选择建议

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

值得选的地方

  • 资料标注 34 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
db MCP (Wannanbigpig)当前 34 stdio · 本地进程 本地部署 无 2026-05-17
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

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方wannanbigpig上游标注的维护方 wannanbigpig
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

db-mcp

中文 | English

让 AI 安全地连上你的 MySQL、Redis、MongoDB

一个面向 Model Context Protocol 的数据库 MCP Server,支持预配置连接、运行时保护、连接状态观测和分级安全模式。

为什么做这个项目

大模型很擅长“查数据、做归纳、解释结果”,但直接把数据库完全暴露给模型,通常会遇到几个问题:

  • 凭证不想反复传给模型
  • 查询结果可能过大,把上下文和服务一起拖垮
  • 写操作需要分级控制,不能一把梭哈
  • 连接掉了、池满了、请求排队了,调用方却看不出来

db-mcp 的目标很明确:把数据库接入 AI 的过程做成一个更稳、更可控、也更适合放到真实工作流里的 MCP 服务。

核心特性

能力 说明
多数据库支持 同时支持 MySQL、Redis、MongoDB
默认更安全 默认 read_only,避免模型误写库
运行时保护 超时、响应裁剪、并发限制、Mongo 查询 limit、MySQL SQL_SELECT_LIMIT
连接感知 支持预配置连接、手动连接、实时连接健康检查
运维可观测 可直接查看连接状态、并发排队、连接池摘要
可接入 MCP 客户端 标准 MCP Server,可接入 Cursor、Claude Desktop 等客户端

示例预览

快速开始

1. 安装```bash

git clone git@github_pig:wannanbigpig/db-mcp.git
cd db-mcp
npm install
npm run build


要求:

- `Node.js >= 18`
- `npm >= 9`

### 2. 运行```bash
npm run dev

或:```bash
node dist/index.js


如果终端输出 `db-mcp 服务器已启动`,说明服务已正常启动。

### 3. 可选配置```bash
cp config.json.example config.json

编辑 config.json,填入你的数据库连接信息。推荐优先使用预配置连接,而不是把数据库密码作为工具参数传给模型。

MCP 客户端配置

db-mcp 是标准 MCP 服务,可接入支持 MCP 的客户端,例如:

  • Codex
  • Cursor
  • Claude Desktop
  • 其他兼容 MCP 的工具

Codex

在 ~/.codex/config.toml 中加入:```toml
[mcp_servers.db-mcp]
command = "node"
args = ["/path/to/db-mcp/dist/index.js"]
enabled = true

[mcp_servers.db-mcp.env]
DB_MCP_SECURITY_MODE = "read_only"
DB_MCP_CONFIG_PATH = "/path/to/config.json"
DB_MCP_MAX_RESPONSE_BYTES = "65536"
DB_MCP_MYSQL_SELECT_LIMIT = "500"


也可以直接使用命令添加:```bash
codex mcp add db-mcp \
--env DB_MCP_SECURITY_MODE=read_only \
--env DB_MCP_CONFIG_PATH=/path/to/config.json \
--env DB_MCP_MAX_RESPONSE_BYTES=65536 \
--env DB_MCP_MYSQL_SELECT_LIMIT=500 \
-- node /path/to/db-mcp/dist/index.js

Cursor```json

{
"mcpServers": {
"db-mcp": {
"command": "node",
"args": ["/path/to/db-mcp/dist/index.js"],
"env": {
"DB_MCP_SECURITY_MODE": "read_only",
"DB_MCP_CONFIG_PATH": "/path/to/config.json"
}
}
}
}


### Claude Desktop```json
{
"mcpServers": {
"db-mcp": {
"command": "node",
"args": ["/path/to/db-mcp/dist/index.js"],
"env": {
"DB_MCP_SECURITY_MODE": "read_only"
}
}
}
}

把 /path/to/db-mcp/dist/index.js 和 /path/to/config.json 替换成你的真实路径即可。

设计理念

预配置连接优先

服务启动时可从 config.json 或环境变量自动建立数据库连接。这样调用 MCP 的 AI 不需要接触数据库密码。

支持的典型环境变量:

  • MYSQL_HOST
  • MYSQL_USER
  • MYSQL_PASSWORD
  • REDIS_HOST
  • REDIS_URL
  • MONGODB_URL

运行时保护不是装饰

以下参数用于防止 MCP 服务被慢查询、大结果集或突发并发打爆:

  • DB_MCP_OPERATION_TIMEOUT_MS
  • DB_MCP_MAX_RESULT_ITEMS
  • DB_MCP_MAX_RESPONSE_BYTES
  • DB_MCP_DEFAULT_MONGO_LIMIT
  • DB_MCP_MAX_MONGO_LIMIT
  • DB_MCP_MYSQL_SELECT_LIMIT
  • DB_MCP_MAX_CONCURRENT_MYSQL
  • DB_MCP_MAX_CONCURRENT_REDIS
  • DB_MCP_MAX_CONCURRENT_MONGO

连接状态可观测

你可以通过工具直接查看:

  • 当前数据库是否配置过
  • 当前连接是否仍然可用
  • MySQL 连接池摘要
  • 各类工具的并发执行和排队情况

安全模式

通过环境变量 DB_MCP_SECURITY_MODE 或工具 set_security_mode 进行设置。

模式 定位 适用场景
read_only 默认只读 生产排查、只读分析
restricted 允许部分写操作 开发调试、日常维护
full_access 完全开放 本地开发、受控测试环境

read_only

  • MySQL:允许 SELECT、SHOW、DESCRIBE、DESC、EXPLAIN
  • Redis:允许 redis_get、redis_type、redis_memory_usage、redis_top_memory_keys、redis_memory_usage_by_prefixes、redis_auto_prefix_memory_usage、redis_hget、redis_hgetall、redis_keys
  • MongoDB:允许 mongodb_find、mongodb_find_one、mongodb_count、mongodb_list_collections

禁止任何数据修改和结构变更。

restricted

  • MySQL:允许常见 SELECT、INSERT、UPDATE
  • MySQL:禁止 DROP、TRUNCATE、ALTER TABLE
  • MySQL:DELETE 必须带 WHERE,结构化工具 mysql_delete 仍会被禁止
  • Redis:允许 redis_set,禁止 redis_del
  • MongoDB:允许插入和更新,禁止删除

full_access

  • MySQL:允许查询、写入和结构变更
  • Redis:允许所有已提供工具
  • MongoDB:允许所有已提供工具

建议:

  • 默认使用 read_only
  • 只在确实需要写数据时切到 restricted
  • 只有明确知道要执行高风险操作时,才使用 full_access

数据库配置

config.json 示例```json

{
"databases": {
"mysql": {
"host": "localhost",
"port": 3306,
"user": "root",
"password": "your_password",
"database": "mydb",
"pool": {
"min": 2,
"max": 10,
"idleTimeout": 60000
}
},
"redis": {
"host": "localhost",
"port": 6379,
"password": "your_password",
"db": 0
},
"mongodb": {
"url": "mongodb://localhost:27017",
"database": "mydb"
}
},
"security": {
"mode": "read_only"
}
}


### 动态连接

除了预配置连接,也支持使用 `*_connect` 工具在运行时手动连接,使用 `*_disconnect` 断开。

如果你担心凭证暴露给模型,优先使用预配置连接。

## 工具一览

### MySQL

- `mysql_connect`: 手动连接 MySQL;仅在未预配置连接或需要覆盖默认连接时使用
- `mysql_query`: 执行 SQL;已预配置连接时可直接使用
- `mysql_insert`
- `mysql_update`
- `mysql_delete`
- `mysql_disconnect`
- `mysql_pool_status`
- `mysql_connection_status`

### Redis

- `redis_connect`
- `redis_get`
- `redis_type`
- `redis_memory_usage`
- `redis_top_memory_keys`
- `redis_memory_usage_by_prefixes`
- `redis_auto_prefix_memory_usage`
- `redis_set`
- `redis_keys`
- `redis_del`
- `redis_hget`
- `redis_hgetall`
- `redis_disconnect`

### MongoDB

- `mongodb_connect`
- `mongodb_find`
- `mongodb_find_one`
- `mongodb_insert_one`
- `mongodb_insert_many`
- `mongodb_update_one`
- `mongodb_delete_one`
- `mongodb_count`
- `mongodb_list_collections`
- `mongodb_disconnect`

### 运行时 / 安全

- `set_security_mode`
- `get_security_mode`
- `server_runtime_status`

## 工具调用示例

以下示例展示各个工具常见的调用参数格式。

### MySQL 查询```json
{ "sql": "SELECT * FROM users WHERE id = ?", "params": [1] }

MySQL 插入```json

{ "table": "users", "data": { "name": "John", "email": "john@example.com" } }


### Redis 写入```json
{ "key": "user:1", "value": "John Doe", "ttl": 3600 }

Redis 键扫描```json

{ "pattern": "user:*", "count": 100, "limit": 200 }


### MongoDB 查询```json
{ "collection": "users", "filter": { "age": { "$gte": 18 } }, "limit": 10 }

运行状态```json

{}


## 可观测性

`server_runtime_status` 可用于快速排查:

- 为什么请求超时
- 为什么结果被裁剪
- 为什么查询在排队
- 为什么 MySQL 连接池被打满
- 当前服务的保护阈值是多少
- 当前数据库连接是否真的还活着

## 开发```bash
npm install
npm run build
npm run dev
npm run watch
npm test

常见问题

为什么建议优先使用预配置连接?

因为这样数据库凭证不需要通过 MCP 工具参数传给模型,风险更低,也更适合长期运行。
这个项目适合直接连生产库吗?

可以,但建议使用 read_only,并配置合理的超时、结果裁剪和并发限制。
为什么还要做运行时保护?

因为模型天然会倾向“多查一点再总结”,没有保护的话,很容易拉出过大的结果集或积压并发请求。

💝 赞助项目

感谢你使用 db-mcp。

如果这个项目对你有帮助,欢迎赞助项目的持续开发和维护。

许可证

MIT

参与贡献

欢迎提交 Issue 和 Pull Request。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
db MCP (Wannanbigpig) 怎么安装?

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

db MCP (Wannanbigpig) 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

db MCP (Wannanbigpig) 收费吗?

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

db MCP (Wannanbigpig) 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

db MCP (Wannanbigpig) 支持哪些客户端?

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

db MCP (Wannanbigpig) 能提供哪些能力?

资料显示约 34 个工具;能力标签包括 多数据库支持、TypeScript、Claude、可观测性。具体工具清单以官方文档为准。

db MCP (Wannanbigpig) 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

db MCP (Wannanbigpig) 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

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

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