MongoDB MCP サーバー
標準化された MCP ツールとリソースを通じて MongoDB データベースへの読み取り専用アクセスを提供するモデル コンテキスト プロトコル サーバー。
概要
この MongoDB MCP サーバーにより、AI アシスタントは書き込みアクセスなしで MongoDB データベースを直接クエリおよび分析できるようになり、データの安全性を維持しながら強力なデータ探索機能を提供できます。
特徴
MongoDB 操作
- データベース探索: データベースとコレクションの一覧表示
- スキーマ検出: サンプルドキュメントからコレクションスキーマを推論する
- クエリ: フィルタリング、プロジェクション、ソート、制限を使用してMongoDBクエリを実行します。
- 集約: 安全性検証を伴う読み取り専用集約パイプラインを実行する
- テキスト検索: テキストインデックスを持つコレクションに対して全文検索を実行します
- 地理空間クエリ: ポイントの近く、ポリゴン内、または交差するジオメトリ内の場所を検索します
- ドキュメント操作: ドキュメントの数を数える、ランダムにドキュメントをサンプリングする、IDでドキュメントを検索する
- データ分析: コレクション統計、インデックス情報、クエリ実行プランを取得します
- パフォーマンスインサイト: クエリ実行プランを調べてパフォーマンスを最適化します
- データ探索: 個別値、フィールド分布、データサンプルを取得する
- フォーマット変換: クエリ結果をJSONまたはCSV形式でエクスポートします
強化された機能
- スキーマ推論: ドキュメントからデータ型と構造を自動的に検出します
- 視覚化のヒント: 結果の内容に基づいてデータの視覚化に関するインテリジェントな提案
- 安全性検証: 集約パイプラインでの書き込み操作を防止します
- 豊富な例を含むドキュメント:各ツールの説明には詳細な例が含まれています
要件
環境変数
MONGODB_URI (必須): 必要に応じて認証付きの MongoDB 接続文字列MONGODB_DEFAULT_DATABASE (オプション): クエリで指定されていない場合のデフォルトのデータベース名
前提条件
- MongoDB サーバーへのネットワーク アクセス
- MongoDB インスタンスに必要な場合の認証資格情報
- 対象データベースに対する適切な読み取り権限
インストール
ソースから構築
依存関係をインストールします:
サーバーを構築します。
自動リビルドを使用した開発の場合:
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を使用してください。
インスペクターは、ブラウザでデバッグ ツールにアクセスするための URL を提供します。