Mongodb Developer Mongodb MCP Server

🚀 MongoDB MCP サーバー

MongoDB データベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコル（Model Context Protocol）サーバーです。このサーバーにより、大規模言語モデル（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 アプリでこのサーバーを使用するには、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 License の下で公開されています。これは、MIT ライセンスの条項と条件に従い、自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。