MongoDB MCP サーバー

標準化された MCP ツールとリソースを通じて MongoDB データベースへの読み取り専用アクセスを提供するモデルコンテキストプロトコルサーバー。

概要

この 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

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

MongoDB MCP Server

Integrations