Mongodb MCP Server 3o3

🚀 MongoDB 模型上下文協議（MCP）服務器

MongoDB 模型上下文協議（MCP）服務器可建立與 MongoDB 的連接，將操作轉換為遵循 MCP 規範的工具，還能進行輸入驗證，為 LLM 客戶端提供結構化數據，保障運行穩定。

🚀 快速開始

1. 安裝依賴

   npm install
   

2. 構建項目

   npm run build
   

3. 開發模式啟動

   npm run dev
   

4. 運行測試

   npm test
   

✨ 主要特性

• 連接數據庫：通過提供的 MongoDB 連接字符串建立連接
• 操作工具：將 MongoDB 操作轉換為遵循 MCP 規範的工具
• 輸入驗證：使用 Zod 進行類型安全和安全性驗證
• 執行查詢：執行查詢並以結構化數據返回給 LLM 客戶端
• 管理連接池：處理連接池和錯誤，確保穩定運行

📦 安裝指南

• 本地運行：通過 npx 方式（如快速開始所示）
• 全局安裝：使用 npm 安裝全局包

  npm install -g @coderay/mongo-mcp-server
  

• Docker 容器：參考倉庫中的 Dockerfile 部署
• 平臺服務：在 Heroku、Vercel 或 AWS 等平臺上部署為服務

🔧 技術細節

• TypeScript：用於類型安全的開發
• MongoDB Node.js 駕駛員：用於數據庫操作
• Zod：用於模式驗證
• 模型上下文協議 SDK：用於服務器實現

📚 詳細文檔

工作原理

1. 使用提供的 MongoDB 連接字符串建立連接
2. 將 MongoDB 操作作為符合 MCP 規範的工具進行暴露
3. 使用 Zod 驗證輸入，確保類型安全和安全性
4. 執行查詢並以結構化數據返回給 LLM 客戶端
5. 管理連接池和錯誤處理

可用工具

查詢工具

• listCollections：列出數據庫中的可用集合
• find：基於過濾器和投影查詢文檔
• insertOne：在集合中插入單個文檔
• updateOne：更新集合中的單個文檔
• deleteOne：從集合中刪除單個文檔

索引工具

• createIndex：創建集合上的新索引
• dropIndex：從集合中刪除索引
• indexes：列出集合的索引

安全注意事項

1. 創建專用 MongoDB 用戶
2. 避免使用管理憑證
3. 啟用訪問日誌記錄
4. 設置適當的讀寫權限
5. 使用連接字符串參數
6. 考慮 IP 白名單

⚠️ 重要提示

始終遵循最小特權原則來配置數據庫訪問。

貢獻指南

歡迎貢獻！請按照以下步驟提交拉取請求：

1. 叉倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 打開拉取請求

📄 許可證

本項目在 MIT 許可證下發布，詳情見 LICENSE 文件。