Multi Db MCP

MCP数据服务

提供方 MdwebbSE

数据服务 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

一个基于MCP协议的HTTP服务器,提供MySQL和MSSQL数据库的查询工具,支持连接池、认证和速率限制。

一句话选型结论

按资料字段整理

Multi Db MCP 属于数据服务类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

数据库工具Python本地部署多数据库支持连接池认证服务速率限制

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

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

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

数据同步与清洗

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

报表取数

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

选择建议

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

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Multi Db MCP当前 6 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

服务器档案

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

详细介绍

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

多数据库MCP服务器

一种模型上下文协议(MCP)HTTP服务器,为MySQL和MSSQL数据库提供数据库查询工具,具有连接池、身份验证和速率限制。

特性

  • 多数据库支持:连接MySQL和MSSQL数据库
  • MCP协议:通过模型上下文协议公开数据库工具
  • 连接池:高效的连接重用,以获得更好的性能
  • 认证:承载令牌身份验证(可配置)
  • 速率限制:内置速率限制以防止滥用
  • 只读模式:可选只读模式以确保安全
  • 行限制:每个查询可配置的最大行数
  • 运输安全:DNS重新绑定保护和CORS支持

Python环境设置

先决条件

  • python:3.9或更高版本

设置虚拟环境

创建虚拟环境(推荐):```bash

Navigate to the project directory

cd /path/to/multi-db-mcp

Create virtual environment

python -m venv venv

Activate

source venv/bin/activate


**验证激活:**```bash
# Should show (venv) prefix
python --version

安装依赖项```bash

Upgrade pip first (recommended)

pip install --upgrade pip

Install required packages

pip install -r requirements.txt

Verify installation

pip list | grep -E "pymysql|mssql|starlette|mcp|uvicorn"


______________________________________________________________________

### 运行服务器```bash
uvicorn server:app --host 0.0.0.0 --port 8001

服务安装

作为Linux服务运行(systemd)

  1. 创建systemd服务文件:```bash
    sudo nano /etc/systemd/system/multi-db-mcp.service

1. 添加以下内容:```ini
[Unit]
Description=Multi-Database MCP Server
After=network.target

[Service]
Type=simple
User=www-data
Group=www-data
WorkingDirectory=/path/to/multi-db-mcp
Environment="PATH=/path/to/multi-db-mcp/venv/bin"
Environment="DB_SERVERS_CONFIG=/path/to/multi-db-mcp/db_servers.json"
Environment="DB_READ_ONLY=true"
ExecStart=/path/to/multi-db-mcp/venv/bin/uvicorn server:app --host 0.0.0.0 --port 8000
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
  1. 安装并启用该服务:```bash
    sudo chown -R www-data:www-data /path/to/multi-db-mcp

sudo systemctl daemon-reload
sudo systemctl enable multi-db-mcp
sudo systemctl start multi-db-mcp


1. 检查服务状态:```bash
sudo systemctl status multi-db-mcp
sudo journalctl -u multi-db-mcp -f

快速开始

1.配置数据库服务器

编辑 db_servers.json 要配置数据库连接,请执行以下操作:```json
{
"transport_security": {
"enable_dns_rebinding_protection": true,
"allowed_hosts": ["localhost:", "127.0.0.1:"],
"allowed_origins": ["http://localhost:", "http://127.0.0.1:"]
},
"servers": {
"main-mysql": {
"engine": "mysql",
"host": "your-mysql-host",
"port": 3306,
"user": "username",
"password": "password",
"allowed_databases": ["mydb"],
"allowed_tables": {
"mydb": ["users", "orders"]
},
"connect_timeout": 10
},
"main-mssql": {
"engine": "mssql",
"host": "your-mssql-host",
"port": 1433,
"user": "username",
"password": "password",
"allowed_databases": ["mydb"],
"encrypt": true,
"trust_server_certificate": false,
"connect_timeout": 10
}
}
}


#### 配置选项

|选项|必填|说明|
|--------|----------|-------------|
| `engine` |是|数据库引擎: `mysql` 或 `mssql` |
| `host` |是|数据库服务器主机名|
| `port` |是|数据库服务器端口|
| `user` |是|身份验证用户名|
| `password` |是|身份验证密码|
| `allowed_databases` |否|此服务器可以访问的数据库列表|
| `allowed_tables` |否|将数据库名称映射到允许的表列表的对象。限制 `preview_table` 和 `select_where` 工具到特定表格。 |
| `connect_timeout` |否|连接超时(秒)(默认值:10)|
| `encrypt` |否|启用加密(仅限MSSQL)|
| `trust_server_certificate` |否|信任服务器证书(仅MSSQL)|

### 2.环境变量

|变量|默认值|描述|
|----------|---------|-------------|
| `DB_SERVERS_CONFIG` | `./db_servers.json` |配置文件的路径|
| `DB_READ_ONLY` | `true` |启用只读模式|
| `DB_MAX_ROWS` | `200` |每个查询返回的最大行数|
| `DB_POOL_MAX_CONNECTIONS` | `10` |每个池的最大连接数|
| `DB_POOL_MIN_CONNECTIONS` | `2` |每个池的最小连接数|
| `DB_POOL_RECYCLE_SECONDS` | `3600` |连接回收时间|
| `MCP_BEARER_TOKEN` |(无)|用于身份验证的承载令牌|
| `RATE_LIMIT_REQUESTS` | `100` |每个费率限制窗口的请求|
| `RATE_LIMIT_WINDOW` | `60` |速率限制窗口(秒)|

## 可用的MCP工具

### `list_tables`

列出数据库中的所有表。

**参数:**

- `db_server` (可选):配置中的数据库服务器名称
- `database` (可选):数据库名称
- `schema` (可选):架构名称(对于MSSQL,默认为“dbo”)

### `describe_table`

获取表的列信息。

**参数:**

- `table_name`:表的名称
- `db_server` (可选):数据库服务器名称
- `database` (可选):数据库名称
- `schema` (可选):架构名称

### `run_query`

执行SQL查询。

**参数:**

- `sql`:要执行的SQL查询
- `db_server` (可选):数据库服务器名称
- `database` (可选):数据库名称

**注:** 在只读模式下,只允许SELECT/SHOW/DESCRIBE/EXPLAIN/WITH查询。

### `preview_table`

预览表中的行。

**参数:**

- `table_name`:表的名称
- `limit` (可选):行数(默认值:50,最大值:200)
- `db_server` (可选):数据库服务器名称
- `database` (可选):数据库名称

### `select_where`

选择带有过滤器的行。

**参数:**

- `table_name`:表的名称
- `filters`:列字典=值过滤器
- `limit` (可选):行数(默认值:50,最大值:200)
- `db_server` (可选):数据库服务器名称
- `database` (可选):数据库名称

### `list_columns`

列出表的列。

**参数:**

- `table_name`:表的名称
- `db_server` (可选):数据库服务器名称
- `database` (可选):数据库名称
- `schema` (可选):架构名称

### `get_current_database`

从请求标头中获取默认的db_server和数据库。

## API终点

|端点|描述|
|----------|-------------|
| `GET /` |健康检查-返回服务器状态|
| `GET /health` |使用服务器配置进行详细的健康检查|
| `POST /` |MCP协议端点|

## 认证

当 `MCP_BEARER_TOKEN` 已设置,除外的所有端点 `/` 和 `/health` 需要一个Bearer令牌:```bash
curl -H "Authorization: Bearer your-token" http://localhost:8001/health

安全考虑

  • 始终使用强承载令牌(至少10个字符)
  • 确保凭据安全,永远不要承诺版本控制
  • 对数据库连接使用SSL/TLS加密
  • 考虑在生产环境中使用只读模式
  • 为您的用例配置适当的速率限制

数据库用户安全

专用数据库用户

强烈建议专门为MCP服务器创建专用数据库用户,而不是使用现有的应用程序或管理帐户。这些专用用户应该具有服务器功能所需的最小权限。

MySQL权限

对于MySQL数据库,建议使用以下最低权限:```sql
-- Grant only necessary permissions
GRANT SELECT, SHOW VIEW, EXECUTE ON your_database.* TO 'mcp_user'@'host';


所需权限:

- `SELECT` -从表中读取数据所需
- `SHOW VIEW` -必需的 `list_tables` 工具正常工作
- `EXECUTE` -如果使用存储过程,则需要

### MSSQL权限

对于MSSQL数据库,建议使用以下最低权限:```sql
-- Create a user with only necessary permissions
USE your_database;
CREATE USER 'mcp_user' FOR LOGIN 'mcp_login';
GRANT SELECT ON SCHEMA::dbo TO 'mcp_user';

所需权限:

  • SELECT 关于相关模式-从表中读取数据时需要

附加安全措施

  • 如果可能,为每个数据库创建单独的用户
  • 限制主机访问('mcp_user'@'localhost' 或特定IP)
  • 为每个数据库用户使用强而唯一的密码
  • 定期审核用户权限
  • 考虑使用数据库角色进行权限管理

输入安全免责声明

MCP服务器包括试图防止恶意代码执行的措施,包括:

  • 查询清理
  • 只读模式强制
  • 速率限制

然而, 最终,用户有责任确保提供给数据库查询的所有输入都是安全的并经过适当验证。服务器无法保证对所有形式的SQL注入或可能由复杂攻击者精心设计的恶意输入提供保护。在通过MCP服务器发送查询之前,始终在客户端验证和净化输入,特别是在接受用户生成的内容时。

项目结构```

multi-db-mcp/
├── server.py # Main HTTP server entry point
├── tools.py # MCP tool definitions
├── db.py # Database connections and helpers
├── config.py # Configuration loading
├── middleware.py # Auth and rate limiting
├── db_servers.json # Database configuration
└── README.md # This file
```

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

常见问题

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

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Multi Db MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Multi Db MCP 收费吗?

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

Multi Db MCP 需要 API Key 吗?

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

Multi Db MCP 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 数据库工具、多数据库支持、Python、认证服务。具体工具清单以官方文档为准。

Multi Db MCP 需要什么运行环境?

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

Multi Db MCP 是本地还是远程?

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

热门专题

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

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