mcp-dbs | 通往MCP之路

View on Smithery

MCP 数据库服务器

一个用于连接和操作各种数据库系统的模型上下文协议（Model Context Protocol, MCP）实现。

支持的数据库

SQLite

PostgreSQL

Microsoft SQL Server

MongoDB

安装

使用方式

MCP 数据库服务器可以在两种模式下运行：

SSE 模式（默认）

默认情况下，服务器以 SSE（Server-Sent Events）模式在端口 3001 上运行：

这将启动一个 HTTP 服务器，并在 http://localhost:3001/mcp 提供一个 SSE 端点。

自定义端口

你可以使用 --port 选项指定自定义端口：

STDIO 模式

对于通过标准输入/输出进行通信的工具，你可以使用 --stdio 选项：

Claude Desktop 集成

你可以通过将 mcp-dbs 添加到 Claude 配置文件来与 Claude Desktop 集成。

配置步骤

打开或创建你的 Claude Desktop 配置文件。

将 mcp-dbs 配置添加到 mcpServers 部分：

将环境变量替换为你自己的数据库连接信息。

注意事项

command 应为 node

在 args 中，提供 mcp-dbs 安装目录中 cli.js 文件的绝对路径

为你的数据库类型配置适当的环境变量（见下文的环境变量部分）

你可以为任何支持的数据库（SQLite、PostgreSQL、SQL Server 或 MongoDB）使用环境变量

与 Claude 一起使用

配置完成后，Claude 将能够使用以下描述的 MCP 工具访问你的数据库。你可以让 Claude：

连接到你的数据库

执行查询并获取结果

探索数据库模式

处理表和数据

工具

connect-database: 连接到数据库

disconnect-database: 断开与数据库的连接

execute-query: 执行查询并返回结果

execute-update: 执行查询但不返回结果

资源

database-schema: 获取完整的数据库模式

table-schema: 获取特定表的模式

tables-list: 获取所有表的列表

使用环境变量进行配置

你可以使用环境变量配置数据库连接：

SQLite

PostgreSQL

SQL Server

MongoDB

这些环境变量将优先于传递给 connect-database 工具的任何配置。

MCP 工具

服务器暴露了以下 MCP 工具：

connect-database

连接到数据库。

参数：

connectionId: 连接的唯一标识符

type: 数据库类型（sqlite、postgres、mssql 或 mongodb）

SQLite 示例：

PostgreSQL 示例：

SQL Server 示例：

MongoDB 示例：

disconnect-database

断开与数据库的连接。

参数：

connectionId: 要断开的连接 ID

execute-query

执行返回结果的查询。

参数：

connectionId: 连接 ID

query: SQL 查询或 MongoDB 聚合管道（作为 JSON 字符串）

params: （可选）查询参数数组。对于 MongoDB，第一个参数是集合名称。

SQL 示例：

MongoDB 示例：

MongoDB 新格式示例（嵌入集合）：

MongoDB shell 语法示例：

MongoDB 直接集合引用 shell 语法示例：

MongoDB 原始命令示例：

execute-update

执行不返回结果的查询（INSERT、UPDATE、DELETE）。

参数：

connectionId: 连接 ID

query: SQL 查询或 MongoDB 命令（作为 JSON 字符串）

params: （可选）查询参数数组。对于 MongoDB，第一个参数是集合名称。

SQL 示例：

MongoDB 示例：

MongoDB 新格式示例（嵌入集合）：

MongoDB shell 语法示例：

MongoDB 直接集合引用 shell 语法示例：

MongoDB 原始命令示例：

MCP 资源

服务器暴露了以下 MCP 资源：

数据库模式

URI: database://{connectionId}/schema

返回数据库的模式信息，包括所有表及其列。

表模式

URI: database://{connectionId}/tables/{tableName}

返回特定表的模式信息，包括其列。

表列表

URI: database://{connectionId}/tables

返回数据库中所有表的列表。

开发

测试

运行测试：

支持项目

如果你觉得这个项目有帮助，可以考虑请我喝杯咖啡！

扫描上面的二维码或点击这里支持项目的开发。

许可证

MIT