🚀 MCP 数据库服务器
MCP 数据库服务器是一个基于 Model Context Protocol (MCP) 的实现，它允许大型语言模型 (LLMs) 通过自然语言与多种数据库进行交互。目前该服务器支持 MongoDB，未来还计划支持 PostgreSQL、CockroachDB、Redis 等更多数据库。
🚀 快速开始
MCP 数据库服务器提供了便捷的方式，让大型语言模型能够以自然语言与数据库交互。以下是使用该服务器的基本步骤。
✨ 主要特性
- 自然语言操作：支持通过自然语言进行数据库操作，降低了使用门槛。
- MongoDB 功能丰富：当前对 MongoDB 的支持涵盖了列出集合、文档查询、插入、删除以及聚合管道操作等。
- 未来拓展性强：计划支持 PostgreSQL、CockroachDB、Redis 等数据库，提供更广泛的数据库操作能力。
📦 安装指南
先决条件
- Node.js v20.12.2 或更高版本
- 数据库（当前为 MongoDB，其他数据库即将推出）
- Claude Desktop 应用程序
安装步骤
- 克隆仓库：
git clone https://github.com/manpreet2000/mcp-database-server.git
cd mcp-database-server
- 安装依赖项：
npm install
- 构建 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 连接字符串。
可用工具
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：支持键值存储操作、列表、集合、哈希表和有序集合操作。
💻 使用示例
基础用法
MongoDB 示例
- 列出数据库中的所有集合：
你能展示我数据库中的所有集合吗？
- 获取特定集合中的记录：
请给我 chargers 集合的两个记录
- 带过滤器的查询：
在 users 集合中显示状态为 active 的所有文档
- 插入文档：
将此 { "name": "Alice", "age": 30 } 插入到 users 集合中
- 删除文档：
从 users 集合中删除 name 等于 Bob 的文档