MongoDB MCP Server
- 最終確認:
- 2026-05-25
- ライセンス:
- Apache-2.0
MongoDB とは
MongoDB は、世界で最も広く使われている NoSQL データベースです。MySQL や PostgreSQL のような「表形式」のデータベース(リレーショナル DB)と異なり、JSON(JavaScript Object Notation)に似た柔軟な形式でデータを保存できる「ドキュメント指向データベース」です。
スタートアップ・Web サービス・モバイルアプリのバックエンドで広く採用されており、「スキーマ(データの型)を厳密に決めずに開発を始められる」柔軟性が支持されています。クラウド版の MongoDB Atlas はサーバー管理不要で、AWS / GCP / Azure 上で簡単に立ち上げられるため、プロダクション運用でも標準的な選択肢になっています。
MongoDB × AI でできること
この MCP サーバーを導入すると、MongoDB の操作を AI への一言で実行できます。
📊 集計パイプライン
「orders で先月の注文を商品カテゴリ別に売上合計集計」
→ aggregation pipeline 実行
📐 スキーマ分析
「users のスキーマを分析して型と必須/任意を一覧化」
→ ドキュメントサンプルから構造推定
☁️ Atlas 接続
「Atlas のプロダクション DB から先週の傾向を分析」
→ クラウド DB に直接アクセス
🐛 デバッグ
「status が error のドキュメント最新 10 件を取得して原因分析」
→ フィルタクエリ + パターン抽出
提供される主なツール
MongoDB MCP Server が公式に提供する主な機能領域(README 明記範囲):
| 機能カテゴリ | 主なツール |
|---|---|
| データベース管理 | データベース一覧・接続情報取得 |
| コレクション操作 | コレクション一覧・スキーマ取得・統計情報 |
| クエリ実行 | find クエリ(フィルタ・ソート・limit 等) |
| 集計パイプライン | aggregation pipeline 実行($match / $group / $sort 等) |
| インデックス管理 | インデックスの一覧・作成・削除(推奨インデックスの提案は Atlas 専用ツール atlas-get-performance-advisor 経由) |
更新系(--readOnly 解除時のみ) | insert / update / delete 操作 |
| 管理操作 | 統計情報・サーバーステータス取得 |
API 実装名について: 個別のツール名は公式リポジトリ でご確認ください。MongoDB ドライバの主要機能をカバーしています。
MongoDB MCP Server について
MongoDB MCP Server は、MongoDB 社(mongodb-js org)が公式に提供する MCP サーバーです(リポジトリ: mongodb-js/mongodb-mcp-server、npm: mongodb-mcp-server)。AI エージェントが MongoDB のデータベースに直接接続し、自然言語でクエリ・集計・スキーマ分析を実行できます。
ローカルの MongoDB インスタンスはもちろん、MongoDB Atlas にも対応しており、クラウド上のプロダクションデータベースへの接続も可能です。サーバーの既定は読み書き可ですが、設定例のように --readOnly フラグを付けることで、読み取り専用モードで安全に利用できます。
スペック
- 配布形態: npm パッケージ(
mongodb-mcp-server)+ Node.js 20+ - 認証: 接続文字列(
MDB_MCP_CONNECTION_STRING)に認証情報を含める - 動作モード:
--readOnly(読み取り専用・推奨)/ フル権限 - 提供元: MongoDB 社(mongodb-js)/ Apache-2.0
- 対応範囲: ローカル MongoDB / MongoDB Atlas
- 公式リポジトリ: github.com/mongodb-js/mongodb-mcp-server
導入手順
前提条件
- Node.js 20 以上
- MongoDB サーバー(ローカル)または MongoDB Atlas 接続 URL
ステップ
- ページ上部のタブから使用環境(Claude Desktop / Cursor / Cline)を選択し、JSON 設定をコピー
MDB_MCP_CONNECTION_STRINGを実際の接続 URL に変更:- ローカル MongoDB:
mongodb://localhost:27017/yourDatabase - 認証あり:
mongodb://user:password@localhost:27017/yourDatabase - MongoDB Atlas:
mongodb+srv://user:password@cluster.mongodb.net/yourDatabase
- ローカル MongoDB:
- 設定ファイルに追記して保存し、クライアントを再起動
MongoDB Atlas 接続の場合: Atlas 管理画面の「Connect」→「Drivers」から接続 URL を取得できます。
動作確認: 「MongoDB に接続して、データベースの一覧を教えて」と話しかけてみてください。
注意事項
- 安全のため、設定例では
--readOnlyフラグを付けています。書き込み操作が必要な場合はフラグを外してください。 MDB_MCP_CONNECTION_STRINGには認証情報が含まれるため、設定ファイルの管理に注意してください。.envファイル等で環境変数化することを推奨します。- MongoDB Atlas 使用時は Atlas 側で IP アクセスリスト(0.0.0.0/0 または固定 IP の許可)の設定が必要です。
- 大量のドキュメント取得は MongoDB のメモリ負荷とネットワーク帯域に影響します。
limitを指定して段階的に取得することを推奨します。
設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop: Anthropic 公式のデスクトップ版 Claude アプリ
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
}
}
}
}
Cursor: AI 機能を内蔵したコードエディタ
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
}
}
}
}
Cline: VS Code に追加する AI アシスタント拡張
{
"mcpServers": {
"mongodb": {
"command": "npx",
"args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
"env": {
"MDB_MCP_CONNECTION_STRING": "mongodb://localhost:27017/myDatabase"
}
}
}
}
主なユースケース
- 「users コレクションで先週登録したユーザー数を集計」と自然言語で MongoDB の集計パイプラインを AI が実行する
- 「このコレクションのスキーマを分析して、インデックスが足りないフィールドを教えて」と最適化提案を AI が行う
- MongoDB Atlas に接続して、プロダクションデータの傾向分析をチャットから直接行える
- 「products コレクションから在庫切れ商品を全件取得して一覧」と複雑なクエリを AI に任せられる
プラットフォーム別の注意事項
- Windows:`MDB_MCP_CONNECTION_STRING` に Windows ローカルの MongoDB を指定する場合は `mongodb://127.0.0.1:27017/` を使用してください。
- プロキシ環境:MongoDB Atlas への接続には安定したインターネット接続が必要です。企業ネットワークでは IP ホワイトリストの設定が必要な場合があります。