Mongodb MCP

🚀 MongoDB MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）に基づき、MongoDB データベースへの読み取り専用アクセスを提供します。標準化されたツールとリソースを通じて、AI アシスタントに強力なデータ探索機能を提供します。

🚀 クイックスタート

MongoDB MCP サーバーを利用することで、AI アシスタントは MongoDB データベースを直接クエリし、分析することができます。読み取り専用アクセスとして設計されているため、データの安全性を確保しつつ、強力なデータ探索機能を提供します。

✨ 主な機能

MongoDB 操作

• データベース探索：すべてのデータベースとコレクションを一覧表示します。
• スキーマ発見：サンプルドキュメントからコレクションのスキーマを推測します。
• クエリ実行：フィルタリング、投影、ソート、制限を伴う MongoDB クエリを実行します。
• 集計：安全に検証された読み取り専用の集計パイプラインを実行します。
• 全文検索：テキストインデックスが設定されたコレクションに対して全文検索を実行します。
• 空間クエリ：特定の点の近く、多角形内、または幾何形状と交差する位置を検索します。
• ドキュメント操作：ドキュメントの数をカウント、ランダムにサンプリング、ID でドキュメントを検索します。
• データ分析：コレクションの統計情報、インデックス情報、クエリ実行計画を取得します。
• パフォーマンス洞察：クエリ実行計画を確認してパフォーマンスを最適化します。
• データ探索：異なる値、フィールドの分布、データサンプルを取得します。
• 形式変換：クエリ結果を JSON または CSV 形式でエクスポートします。

拡張機能

• スキーマ推論：ドキュメント内のデータ型と構造を自動検出します。
• スマートな可視化提案：結果の内容に基づいたスマートなデータ可視化提案を提供します。
• セキュリティ検証：集計パイプライン内の書き込み操作を防止します。
• 例豊富なドキュメント：各ツールの説明に詳細な例が含まれています。

📦 インストール

ソースコードからのビルド

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

開発時に自動的に再構築します：

npm run watch

Claude デスクトップとの統合

Claude デスクトップで使用するには、サーバー設定を追加します。

MacOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mongodb": {
      "command": "/path/to/mongodb-server/build/index.js",
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Claude Web との統合

MCP Chrome 拡張を通じて Claude Web で使用するには、設定を Cline MCP 設定に追加します。

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": ["/path/to/mongodb-server/build/index.js"],
      "env": {
        "MONGODB_URI": "mongodb://username:password@hostname:port/database",
        "MONGODB_DEFAULT_DATABASE": "your_default_db"
      }
    }
  }
}

Claude Code との統合

Claude Code で使用するには、以下のコマンドを実行します。

cd /path/to/my/project
claude mcp add mongo-server /path/to/mongodb-mcp/build/index.js -e "MONGODB_URI=mongodb://user@password:27017/dbname?authSource=authDbName" -e MONGO_DEFAULT_DATABASE=dbname 

必ずプレースホルダーを実際の MongoDB 接続文字列とデフォルトのデータベース名に置き換えてください。

📚 ドキュメント

環境変数

• MONGODB_URI（必須）：MongoDB 接続文字列。認証が必要な場合はユーザー名とパスワードを含みます。
• MONGODB_DEFAULT_DATABASE（オプション）：指定されない場合に使用されるデフォルトのデータベース名。

要件

• MongoDB サーバーへのネットワークアクセス権。
• MongoDB インスタンスが認証を要求する場合は、適切な認証資格情報を提供します。
• ターゲットデータベースに対する適切な読み取り権限。

🔧 技術詳細

MCP サーバーは標準入出力を通じて通信するため、デバッグは難しい場合があります。利用可能な MCP インスペクター を使用してください。これはパッケージスクリプトとして提供されています。

npm run inspector

インスペクターは、ブラウザでアクセスできるデバッグツールの URL を提供します。