Mongodb MCP Server

🚀 📢 コミュニティサーバー通知

これはコミュニティによって維持されているMCPサーバーです。👉 公式のMongoDB MCPサーバーにアクセスするには、mongodb-js/mongodb-mcp-server をご覧ください。

🚀 クイックスタート

MongoDB MCPサーバーは、MongoDBデータベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーにより、LLMはコレクションスキーマを確認し、集計パイプラインを実行することができます。

✨ 主な機能

ツール

• aggregate

  • 接続されたデータベースでMongoDB集計パイプラインを実行します。
  • 入力:
    • collection (文字列)：クエリを実行するコレクション。
    • pipeline (配列)：MongoDB集計パイプラインの段階。
    • options (オブジェクト)：オプションの集計設定。
      • allowDiskUse (ブール値)：ディスク操作の使用を許可します。
      • maxTimeMS (数値)：最大実行時間（ミリ秒）。
      • comment (文字列)：操作を識別するコメント。
  • 制限段階が指定されていない場合、デフォルトのドキュメント制限は1000個です。
  • デフォルトのタイムアウト時間は30秒です。

• explain

  • 集計パイプラインの実行計画を取得します。
  • 入力:
    • collection (文字列)：分析するコレクション。
    • pipeline (配列)：MongoDB集計パイプラインの段階。
    • verbosity (文字列)：説明の詳細度。
      • オプション："queryPlanner"、"executionStats"、"allPlansExecution"
      • デフォルト："queryPlanner"

リソース

サーバーは各データベースコレクションのスキーマ情報を提供します。

• コレクションスキーマ (mongodb://<host>/<collection>/schema)
  • コレクションの推論されたJSONスキーマ情報。
  • フィールド名とデータ型を含みます。
  • スキーマはサンプルドキュメントから推論されます。

📦 インストール

Claude Desktopアプリでこのサーバーを使用するには、claude_desktop_config.jsonファイルの“mcpServers”セクションに以下の設定を追加します。

"mongodb": {
      "command": "npx",
      "args": [
        "-y" ,
        "@pash1986/mcp-server-mongodb"
      ],
     "env" : {
	"MONGODB_URI" : "mongodb+srv://<yourcluster>" // 'mongodb://localhost:27017'
	}
    }

mydbをご自身のデータベース名に置き換え、必要に応じて接続文字列を調整してください。

💻 使用例

基本的な使用法

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$group": {
      "_id": "$city",
      "avgAge": { "$avg": "$age" },
      "count": { "$sum": 1 }
    }},
    { "$sort": { "count": -1 } },
    { "$limit": 10 }
  ],
  "options": {
    "allowDiskUse": true,
    "maxTimeMS": 60000,
    "comment": "City-wise user statistics"
  }
}

高度な使用法

{
  "collection": "users",
  "pipeline": [
    { "$match": { "age": { "$gt": 21 } } },
    { "$sort": { "age": 1 } }
  ],
  "verbosity": "executionStats"
}

🔧 技術詳細

• パイプラインに制限が指定されていない場合、デフォルトの制限は1000個のドキュメントです。
• すべての操作のデフォルトのタイムアウト時間は30秒です。
• 読み取り専用操作です。
• コレクションサンプルの安全なスキーマから推論されます。

📄 ライセンス

このMCPサーバーはMITライセンスの下で公開されています。これは、MITライセンスの条項と条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。