Mongodb Database

🚀 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 應用程序

安裝步驟

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 連接字符串。

可用工具

• 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 的文檔