Mcpmongo

🚀 MCP MongoDB 集成

本項目實現了 MongoDB 與模型上下文協議（MCP）的集成，為 AI 助手賦予了數據庫交互能力。它主要包含兩個核心組件：

• MCP MongoDB 服務器：將 MongoDB 操作封裝為 MCP 工具的服務器。
• 客戶端 Gemini 集成：基於終端的聊天機器人，藉助 Google 的 Gemini AI 實現對 MongoDB 的訪問。

🚀 快速開始

先決條件

• Node.js (v14 或更高)
• MongoDB 實例（本地或遠程）
• Google Gemini API 密鑰

設置說明

1. 服務器設置

# 切換到服務器目錄
cd mcp-mongo-project

# 安裝依賴
npm install

# 創建包含 MongoDB 連接詳細信息的 .env 文件
echo "MONGODB_URI=mongodb://localhost:27017" > .env
echo "MONGODB_NAME=your_database_name" >> .env

# 啟動服務器
npm start

2. 客戶端設置

# 切換到客戶端目錄
cd client-side

# 安裝依賴
npm install

# 創建包含 Gemini API 密鑰的 .env 文件
echo "GEMINI_API_KEY=your_gemini_api_key" > .env

# 啟動客戶端
node index.js

✨ 主要特性

• MongoDB 集成：將完整的 CRUD 操作作為 MCP 工具暴露。
• MCP 服務器：實現模型上下文協議，供 AI 工具使用。
• Gemini AI 集成：與 Google 的 Gemini 模型建立連接。
• 終端聊天機器人：提供交互式聊天界面，方便進行數據庫操作。

📦 安裝指南

服務器設置

# 切換到服務器目錄
cd mcp-mongo-project

# 安裝依賴
npm install

# 創建包含 MongoDB 連接詳細信息的 .env 文件
echo "MONGODB_URI=mongodb://localhost:27017" > .env
echo "MONGODB_NAME=your_database_name" >> .env

# 啟動服務器
npm start

客戶端設置

# 切換到客戶端目錄
cd client-side

# 安裝依賴
npm install

# 創建包含 Gemini API 密鑰的 .env 文件
echo "GEMINI_API_KEY=your_gemini_api_key" > .env

# 啟動客戶端
node index.js

💻 使用示例

基礎用法

一旦服務器和客戶端都在運行，就可以通過聊天界面與 MongoDB 進行交互：

您：顯示數據庫中的所有集合
AI：在數據庫中找到 3 個集合
[
  "users",
  "products",
  "orders"
]

您：查找年齡大於 30 的所有用戶
AI：在集合 'users' 中找到 2 個文檔
[
  {
    "_id": "6450a7c63020e15b2a1a",
    "name": "張三",
    "age": 35
  },
  {
    "_id": "6450a7d03020e15b2a1b",
    "name": "李四",
    "age": 32
  }
]

📚 詳細文檔

可用的 MongoDB 工具

MCP 服務器將以下 MongoDB 操作作為工具暴露：

• findDocuments：查詢集合中的文檔
• findOneDocument：查找單個文檔
• insertOneDocument：插入一個文檔
• insertManyDocuments：插入多個文檔
• updateOneDocument：更新單個文檔
• updateManyDocuments：更新多個文檔
• deleteOneDocument：刪除一個文檔
• deleteManyDocuments：刪除多個文檔
• aggregateDocuments：運行聚合管道
• countDocuments：計算集合中的文檔數
• listCollections：列出所有集合
• createCollection：創建新集合

項目結構

.
├── client-side/            # 客戶端應用程序使用 Gemini AI
│   ├── index.js            # 客戶端主應用程序
│   └── package.json        # 客戶端依賴
└── mcp-mongo-project/      # MCP 服務器帶有 MongoDB 工具
    ├── src/
    │   ├── index.js        # 服務器設置和工具定義
    │   └── services/
    │       └── mcp-service.js  # MongoDB 服務實現
    └── package.json        # 服務器依賴

🔧 技術細節

• MCP 協議：定義了 AI 助手與外部系統交互的標準接口。
• MongoDB 集成：通過 MCP 協議將 MongoDB 數據庫連接到 Gemini AI。
• 終端聊天機器人：提供用戶友好的界面，進行數據庫查詢和操作。

📄 許可證

[在此處插入許可證信息]

貢獻者

[在此處列出貢獻者]

鏈接

[在此處添加相關鏈接]