MCP 数据库服务器

一个 Model Context Protocol (MCP) 服务器实现，允许大型语言模型（LLMs）通过自然语言与多种数据库交互。目前支持 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\ Support/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集合的2条记录

3. 带过滤条件的查询：

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

4. 插入一个文档：

在users集合中添加一个新的用户，名字是John，邮箱是john@example.com

5. 删除一个文档：

从users集合中删除邮箱为john@example.com的用户

6. 聚合操作：

给我看一下users集合中按状态分类的用户总数

可用工具

1. getCollections

列出数据库中的所有集合。

2. getCollection

获取指定名称的集合。

参数：

• collectionName: 需要获取的集合名称。

3. find

执行查询操作，返回指定数量的结果。

参数：

• collectionName: 要查询的集合名称。
• query（可选）：查询条件。
• limit（可选）：限制返回结果的数量，默认为5。

4. findOne

执行单个文档查询。

参数：

• collectionName: 要查询的集合名称。
• query: 查询条件。

5. insertOne

插入一个新文档。

参数：

• collectionName: 文档要插入到哪个集合。
• document: 要插入的文档内容。

6. deleteOne

删除指定查询匹配的第一个文档。

参数：

• collectionName: 要删除文档所在的集合。
• query: 删除条件。

7. updateOne

更新指定查询匹配的第一个文档，设置新的值。

参数：

• collectionName: 文档要更新的集合。
• query: 更新条件。
• update: 新的值。

未来支持

未来将支持以下数据库：

• PostgreSQL：通过自然语言执行复杂的 SQL 查询和表操作。
• CockroachDB：在分布式环境中执行高效的 SQL 操作。
• Redis：利用键值对存储和缓存功能，实现快速数据访问。

安全注意事项

• 保密性：确保 MongoDB 连接字符串不被泄露。建议使用环境变量来管理敏感信息。
• 认证：在生产环境中启用身份验证机制，保护数据库免受未授权访问。

贡献指南

如果您发现任何问题或有改进建议，请考虑提交一个 GitHub 问题或拉取请求（Pull Request）。您的贡献将帮助我们不断改进 MCP 数据库服务器的功能和性能。