MongoDB MCP Server

MongoDB MCP サーバー

標準化された MCP ツールとリソースを通じて、MongoDB データベースへの読み取り専用アクセスを提供する Model Context Protocol サーバーです。

概要

この MongoDB MCP サーバーを使用すると、AI アシスタントは書き込みアクセス権を持たずに MongoDB データベースを直接クエリして分析できます。データの安全性を保ちながら、強力なデータ探索機能を利用できます。

機能

MongoDB の操作

• データベースの探索：データベースとコレクションを一覧表示します
• スキーマの検出：サンプルドキュメントからコレクションのスキーマを推定します
• クエリ：フィルタリング、プロジェクション、ソート、件数制限を指定して MongoDB クエリを実行します
• 集計：安全性を検証したうえで、読み取り専用の集計パイプラインを実行します
• テキスト検索：テキストインデックスを持つコレクションで全文検索を実行します
• 地理空間クエリ：地点付近、ポリゴン内、またはジオメトリと交差する位置を検索します
• ドキュメント操作：ドキュメント数のカウント、ランダムなドキュメントのサンプリング、ID によるドキュメント検索を行います
• データ分析：コレクションの統計情報、インデックス情報、クエリ実行計画を取得します
• パフォーマンス分析：クエリ実行計画を調べてパフォーマンスを最適化します
• データ探索：個別の値、フィールドの分布、データサンプルを取得します
• 形式変換：クエリ結果を JSON または CSV 形式でエクスポートします

拡張機能

• スキーマ推定：ドキュメントからデータ型と構造を自動的に検出します
• 可視化のヒント：結果の内容に基づいて、データ可視化のためのインテリジェントな提案を行います
• 安全性の検証：集計パイプライン内での書き込み操作を防止します
• 例が豊富なドキュメント：各ツールの説明には詳細な例が含まれています

要件

環境変数

• MONGODB_URI（必須）：必要に応じて認証情報を含む MongoDB 接続文字列
• MONGODB_DEFAULT_DATABASE（任意）：クエリで指定されていない場合に使用するデフォルトのデータベース名

前提条件

• MongoDB サーバーへのネットワークアクセス
• MongoDB インスタンスで必要とされる場合は認証情報
• 対象データベースに対する適切な読み取り権限

インストール

ソースからビルド

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

npm install

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

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

Claude Desktop との統合

Claude Desktop で使用するには、サーバーの設定を追加します：

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 接続文字列とデフォルトのデータベース名に置き換えてください。

正しく設定されていれば、claude の実行時に次のように表示されます：

╭───────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!            │
│                                                       │
│   /help for help                                      │
│                                                       │
│   cwd: <path-to-project-directory>                    │
│                                                       │
│   ─────────────────────────────────────────────────── │
│                                                       │
│   MCP Servers:                                        │
│                                                       │
│   • mongo-server                            connected │
╰───────────────────────────────────────────────────────╯

問題が発生した場合は、Claude Code のドキュメントを参照してください。

セキュリティに関する考慮事項

• このサーバーは設計上、読み取り専用アクセスを提供します
• 接続文字列には機密性の高い認証情報が含まれる場合があります
• 接続文字列は環境変数に安全に保存してください
• 読み取り専用権限を持つ MongoDB ユーザーを使用してください

デバッグ

MCP サーバーは標準入出力（stdio）経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector を使用してください：

npm run inspector

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。