MCP 数据库服务器

一个允许大型语言模型 (LLMs) 通过自然语言与多种数据库交互的 Model Context Protocol (MCP) 服务器实现。目前支持 MongoDB，计划未来支持：

• PostgreSQL
• CockroachDB
• Redis
• 等等...

功能

• 通过自然语言进行数据库操作
• 当前 MongoDB 支持的功能包括：
  • 列出所有集合
  • 带过滤和投影的文档查询
  • 插入文档
  • 删除文档
  • 聚合管道操作
• 未来其他数据库的支持：
  • PostgreSQL：执行 SQL 查询、表操作
  • CockroachDB：分布式 SQL 操作
  • Redis：键值操作、缓存

先决条件

• Node.js v20.12.2 或更高版本
• 数据库（当前为 MongoDB，其他数据库即将推出）
• Claude Desktop 应用程序

安装

1. 克隆仓库：

git clone https://github.com/manpreet2000/mcp-database-server.git
cd mcp-database-server

2. 安装依赖项：

npm install

3. 构建 TypeScript 代码：

npm run build

配置

要开始使用，请在您的 Claude Desktop 配置文件中配置数据库连接：

MacOS

~/Library/Application\ 支持/Claude/claude_desktop_config.json

Windows

%APPDATA%/Claude/claude_desktop_config.json

将以下配置添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "database": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-database/dist/index.js"],
      "env": {
        "MONGODB_URI": "your-mongodb-connection-string"
      }
    }
  }
}

替换：

• /path/to/node 为您安装的 Node.js 可执行文件路径，或直接使用 node
• /path/to/mcp-database 为此仓库的绝对路径
• your-mongodb-connection-string 为您的 MongoDB 连接字符串

使用示例

MongoDB 示例

1. 列出数据库中的所有集合：

你能展示我数据库中的所有集合吗？

2. 获取特定集合中的记录：

请给我 chargers 集合的两个记录

3. 带过滤器的查询：

在 users 集合中显示状态为 active 的所有文档

4. 插入文档：

将此 { "name": "Alice", "age": 30 } 插入到 users 集合中

5. 删除文档：

从 users 集合中删除 name 等于 Bob 的文档

可用工具

• getCollections(): 返回数据库中的所有集合。
• getCollection(collectionName): 返回指定集合的引用。
• find(query, projection): 根据查询条件和投影执行查找操作。
• insertOne(document): 向集合中插入单个文档。
• insertMany(documents): 向集合中插入多个文档。
• updateOne(query, update): 更新满足查询条件的第一个文档。
• updateMany(query, update): 更新满足查询条件的所有文档。
• replaceOne(query, replacement): 替换满足查询条件的第一个文档。
• deleteOne(query): 删除满足查询条件的第一个文档。
• deleteMany(query): 删除满足查询条件的所有文档。

未来数据库支持

• PostgreSQL：执行 SQL 查询、表操作、模式管理
• CockroachDB：分布式事务、执行 SQL 操作
• Redis：键值存储操作、列表、集合、哈希表和有序集合操作