MongoDB MCP サーバー

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

コンポーネント

ツール

• 集計

  • 接続されたデータベースに対してMongoDB集計パイプラインを実行する

  • 入力：

    • collection (文字列): クエリするコレクション

    • pipeline （配列）：MongoDB 集約パイプラインのステージ

    • options (オブジェクト): オプションの集計設定

      • allowDiskUse (boolean): ディスク使用を必要とする操作を許可する

      • maxTimeMS (数値): 最大実行時間（ミリ秒）

      • comment (文字列): 操作を識別するためのコメント

  • 制限ステージが指定されていない場合、デフォルトの制限は 1000 ドキュメントです

  • デフォルトのタイムアウトは30秒です

• 説明する

  • 集計パイプラインの実行プランを取得する

  • 入力：

    • collection （文字列）：分析するコレクション

    • pipeline （配列）：MongoDB 集約パイプラインのステージ

    • verbosity （文字列）：説明の詳細レベル

      • オプション: 「queryPlanner」、「executionStats」、「allPlansExecution」

      • デフォルト: "queryPlanner"

リソース

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

• コレクションスキーマ( mongodb://<host>/<collection>/schema )

  • 各コレクションの推論されたJSONスキーマ情報

  • フィールド名とデータ型が含まれます

  • スキーマはサンプルコレクション文書から派生されます

Related MCP server: legacy-mongodb-mcp

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ライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。