MongoDB MCP サーバーを使用すると、MCP をサポートするAIクライアントからの自然言語クエリを使用してMongoDBクラスターと交流することができます。このページでは MCP サーバー ツールについて説明します。
Overview
MongoDB MCPサーバーは次のツール カテゴリを提供します。
Atlas ツール。組織、プロジェクト、クラスター、データベースユーザーアカウント、パフォーマンス推奨事項の取得など、Atlas システム リソースに対して操作を実行します。
ローカル Atlas 配置ツール。ローカル Atlas 配置を一覧表示、接続、作成、削除することができます。
データベース ツールは、ドキュメントの挿入、更新、削除するなどの操作や、クエリや集計パイプラインの実行を行います。
Assistant ツールは、MongoDB Assistant 知識ベースを検索して、公式ドキュメントとキュレーションされたガイダンスを提供します。
MongoDB Atlas Managed MCP サーバーと MongoDB MCP サーバーのローカル MCP の両方で、すべての Atlas ツールと データベースツールが使用できるわけではありません。これらの表の各行の Atlas マネージドと ローカルの列は、MCP 配置タイプが指定されたツールをサポートするかどうかを示します。
MongoDB MCP サーバーがこれらのツールとサンプル出力をどのように使用するかの詳細な例については、MongoDB MCP サーバー 使用例。 を参照してください。
MCP サーバー Atlas ツール
Atlas ツールは、MongoDB MCP サーバーの使用開始 に記述されているように Atlas API 認証情報を設定している場合にのみ利用できます。
次の表では、Atlas ツールについて説明しています。「Atlas Managed」と「Local」の列は、各ツールが MongoDB Atlas Managed MCP サーバーと MongoDB MCP サーバーの Local MCP で利用できるかどうかを示しています。
Atlas ツール名 | 説明 | Atlas マネージド | ローカル |
|---|---|---|---|
| Atlas 組織の一覧を返します。 | ||
| Atlas プロジェクトの一覧を返します。 | ||
| 新しい Atlasプロジェクトを作成します。 | ||
| Atlas クラスターの一覧を返します。 | ||
| 特定の Atlas クラスターに関する情報を返します。 | ||
| 無料の Atlas クラスターを作成します。 | ||
| 構成されたサービス アカウントを使用して Atlas クラスターに接続します。 接続文字列を指定せずに MCPサーバーを構成した場合、このツールは接続を確立するためにランダムなパスワードを持つ一時データベースユーザーを作成します。詳細については、ツールの詳細を参照してください。 | ||
| クラウドプロバイダー ( | ||
| 次の Atlas クラスターのアップグレードをサポートします。
オプションで、ターゲットの 専有クラスターの場合、クラスターを別の M10〜M80 インスタンスサイズに増やすことができます。また、クラスターのコンピュート自動スケーリング設定を更新できます。少なくと 1 つの次のオプションを指定します。
拡大は選出可能ノードと読み取り専用ノードに適用されます。このツールは、分析ノード、マルチシャードクラスター、またはリージョンが異なるインスタンスサイズを使用するクラスターを増やしません。 | ||
| M10–M80 インスタンスサイズの専用 Atlas クラスターを作成します。1 から 3 つのリージョンでレプリカセットと単一シャードクラスタータイプをサポートします。
| ||
| 専用 (M10+) Atlas クラスターを一時停止または再開します。Free クラスターと Flex クラスターは一時停止できません。
| ||
| Atlas クラスターにアクセスできるIPとCIDR 範囲に関する情報を返します。 | ||
| Atlas クラスターのIPと CIDR アクセス リストを設定します。 | ||
| Atlasデータベースユーザーの一覧を返します。 | ||
| Atlasデータベースユーザーを作成します。 | ||
| Atlasプロジェクトでトリガーされたアラートのリストを返します。これらはAtlasが生成したアラートであり、それらを定義するアラート設定ではありません。デフォルトは | ||
| Atlas クラスターの Performance Advisor の推奨事項を返します。推奨インデックス、削除インデックス、低速クエリ ログ、スキーマ提案の操作をサポートします。 詳細については、Performance Advisor ツールを参照してください。 | ||
| サンプル データセットを Atlas クラスターにロードします。 | ||
| リモート MCP サーバー上の Atlas クラスターに接続します。 | ||
| Atlas Stream Processing のワークスペース、プロセッサ、パブリック接続、またはプライベートリンク ネットワーク接続に関する情報を返します。 リモート MCP サーバーでは、Atlas Stream Processing ツールが | ||
| Atlas Stream Processing ワークスペース、プロセッサ、パブリック接続、またはプライベートリンク ネットワーク接続を作成します。 | ||
| Atlas Stream Processing のワークスペース、プロセッサ、またはパブリック接続を管理します。MongoDB MCP サーバーは次のことが可能です。
| ||
| Atlas Stream Processing のワークスペース、プロセッサ、パブリック接続、またはプライベートリンク ネットワーク接続を削除します。 |
MCP サーバー ローカル Atlas ツール
ローカル Atlas 配置で Local MCP を使用できます。そのためには、Docker をインストールする必要があります。ローカル Atlas 配置の概要については、「ローカル Atlas 配置の作成」を参照してください。
次の表では、ローカルのAtlasツールについて説明します。これらのツールは、Local MCP for MongoDB MCP サーバーでのみ使用できます。
MCP サーバー ローカル Atlas ツール名 | 説明 |
|---|---|
| Atlas のローカル配置を一覧表示します。 |
| Atlas のローカル配置を作成します。このツールを実行するには、読み取り専用モードを無効にする必要があります。 |
| Atlas のローカル配置に接続します。 |
| Atlas のローカル配置を削除します。このツールを実行するには、読み取り専用モードを無効にする必要があります。 |
ローカル Atlas ツールを実行する例については、ローカル Atlas 配置 を参照してください。
MCP サーバーDatabase Tools
次の表では、データベースツールについて説明しています。「Atlas Managed」と「Local」の列は、各ツールが MongoDB Atlas Managed MCP サーバーと MongoDB MCP サーバーの Local MCP で利用できるかどうかを示しています。
データベースツール名 | 説明 | Atlas マネージド | ローカル |
|---|---|---|---|
| MongoDBクラスターに接続します。 | ||
| MongoDB接続を閉じ、その接続IDを無効にします。 | ||
| アクティブなMongoDB接続とその接続IDのリストを返します。確立された接続の接続IDを見つけるには、このツールを使用します。 | ||
| MongoDBデータベースクエリを実行します。 | ||
| MongoDB集計パイプラインを実行します。 | ||
| データベースレベルで MongoDB 集計パイプラインを実行します。 | ||
| コレクション内のドキュメントの数を返します。 | ||
| 評価されたメソッドのクエリオプティマイザによって選択された当選プランの実行を説明する統計を返します。 | ||
| ドキュメント をコレクションに追加します。 | ||
| コレクションにインデックスを作成します。このツールは、ベクトル検索インデックスと語彙検索インデックスの作成をサポートしています。 | ||
| 指定されたデータベースとコレクションのインデックスを削除します。このツールは、ベクトル検索インデックスとレキシカル検索インデックスの削除をサポートしています。 | ||
| コレクションの複数のドキュメントを変更します。 | ||
| コレクションの名前を変更します。 | ||
| 新しいコレクションを作成します。 | ||
| コレクションからドキュメントを削除します。 | ||
| データベースからコレクションを削除します。 | ||
| データベースを削除します。 | ||
| 現在の接続で使用可能なすべてのデータベースの一覧を返します。 | ||
| データベース内のコレクションの一覧を返します。 | ||
| コレクションのインデックスに関する情報を返します。これには、ベクトル検索インデックスや語彙検索インデックスが含まれます。 | ||
| コレクションスキーマ情報を返します。 | ||
| コレクションのサイズをメガバイト単位で返します。 | ||
| データベースの統計情報を返します。 | ||
| クエリまたは集計パイプラインの結果をJSON形式で、 MCP サーバー を実行するコンピュータ上のファイルに保存します。また、AIクライアントアプリケーションの | ||
| 最新のログに記録された |
MCP サーバー アシスタント ツール
アシスタント ツールにより、AI クライアントは MongoDB Assistant 知識ベースにアクセスできます。この知識ベースには、MongoDB の公式ドキュメント、厳選された専門家のガイダンス、MongoDB が提供するその他のリソースが含まれます。これらのツールにより、AI クライアントは訓練データのみに依存するのではなく、正確なバージョン固有の MongoDB 情報を取得できます。
次の表はアシスタント ツールについて説明します。
MCP サーバー アシスタント ツール名 | 説明 |
|---|---|
| MongoDB Assistantの知識ベースで利用可能なデータソースを表示します。これを使用して利用可能なデータソースを検索するか、 |
| MongoDB Assistantの知識ベースで情報を検索します。知識ベースには、公式ドキュメント、厳選された専門家によるガイダンス、およびMongoDBが提供するその他のリソースが含まれています。データソースおよびバージョンによるフィルターをサポートしています。 |
ツールの詳細
特定の MCP ツールに関する追加情報については、次のセクションを参照してください。
ベクトル検索のサポート
MongoDB MCP サーバーはMongoDB ベクトル検索をサポートしています。自然言語プロンプトを使用して、ベクトル検索インデックスを作成および管理し、埋め込みを生成し、セマンティック検索クエリを実行できます。次の表に主な機能をまとめています。
ユースケース | プロンプトの例 | 関連ツール |
|---|---|---|
インデックスの管理 |
|
|
自動埋め込みによるドキュメントの挿入 |
|
|
ベクトル検索クエリ |
|
|
詳しくは次のリソースを使用してください。
ベクトル検索に使用されるデータベースツール（
create-index、collection-indexes、drop-index、insert-many、aggregateなど）の説明については、MCP Server Database Tools テーブルを参照してください。詳細な使用例とサンプル出力については、ベクトル検索を参照してください。
ベクトル検索用に MCP サーバーを構成するには、torageApiKey を参照してください。
ベクトル検索の詳細については、MongoDB ベクトル検索 概要を参照してください。
語彙検索のサポート
MongoDB MCP ServerはMongoDB Searchをサポートしています。自然言語プロンプトを使用して、語彙検索インデックスを作成および管理し、全文検索クエリを実行できます。これには、$search集計ステージを使用して関連するドキュメントを返し、$searchMeta集計ステージを使用して関連するドキュメントの数などの結果に関するメタデータを返すクエリが含まれます。次の表は、主な機能をまとめたものです。
ユースケース | プロンプトの例 | 関連ツール |
|---|---|---|
インデックスの管理 |
|
|
語彙検索クエリ |
|
|
詳しくは次のリソースを使用してください。
語彙検索に使用される Database Tools の説明については、例えば
create-index、collection-indexes、drop-index、aggregateなどの MCP サーバー Database Tools テーブルを参照してください。詳細な使用例とサンプル出力については、Lexical Searchを参照してください。
MongoDB がどのように語彙検索を実行するかについて詳しくは、「MongoDB Search 概要」を参照してください。
Atlas Stream Processing のサポート
MongoDB MCP サーバーを使用して、Atlas Stream Processing リソースと交流できます。Atlas Stream Processing を使用すると、Atlas データベースで使用されるのと同じ集計操作を使用して、データのストリームを継続的に読み取り、書き込み、変換できます。すべての実行中のプロセッサーに課金が発生します。
Atlas Stream Processing ツール (atlas-streams-discover、atlas-streams-build、atlas-streams-manage、atlas-streams-teardown)は、ローカル MCP サーバーと Atlas マネージド MCP サーバーの両方で利用できます。ツールの説明については、「MCP サーバー Atlas ツール」テーブルを参照してください。
詳しくは、Atlas Stream Processing を参照してください。
埋め込みの自動生成
MongoDB MCP サーバーは、ベクトル埋め込みを生成するための 2 つの独立したメカニズムをサポートしています。
MCP サーバー埋め込み生成: MCP サーバーは、ドキュメントをMongoDBに送信する前に、Voyage AIを使用してクライアント側で埋め込みを生成します。これにはVoyage AI APIキーが必要です。
MongoDB自動埋め込み: MongoDB は、ドキュメントが挿入または更新されるときに、サーバー側で埋め込みを自動的に生成します。詳細については、 MongoDB の自動埋め込み を参照してください。
これらのメカニズムは独立して機能し、ユースケースに応じて一緒に使用することも、個別に使用することもできます。
MCP サーバー の埋め込み生成には、ローカル MCP サーバー で構成されたVoyage AI API キーが必要であります。したがって、ローカル MCP サーバー でのみ利用できます。MongoDB 自動埋め込みは MongoDB 内で埋め込みを生成し、MCP サーバー構成に依存しません。
MCP サーバー埋め込み生成
MCP サーバーを Voyage AI APIキーで構成すると、サーバーは次の方法で埋め込みを自動的に生成できます。
ドキュメントの埋め込みを生成:
insert-manyツールを使用する場合に、ドキュメントにテキストフィールドを埋め込みます。クエリの埋め込みを生成:
aggregateツールを使用してベクトル検索クエリを実行中に、検索クエリを埋め込みます。具体的には、サーバーは$vectorSearch集計クエリのqueryVectorパラメータの埋め込みを生成します。
MCP サーバーは次の投票AI埋め込みモデルをサポートしています。
voyage-3-largevoyage-3.5voyage-3.5-litevoyage-code-3
Vyage AIモデルの詳細については、Vyage AI のドキュメント を参照してください。
注意
デフォルトでは 、 MongoDB MCP サーバーはベクトル検索インデックスを持つフィールドに有効なベクトル埋め込みが含まれていることを検証し、ベクトル検索インデックスの破損を防ぎます。この動作を無効にするには、disableEmbeddingsValidation オプションを true に設定します。詳しくは、voyageApiKey を参照してください。
MongoDB自動埋め込み
重要
ベクトル検索インデックスへの自動埋め込みは、プレビュー機能として MongoDB Community Edition v8.2 以降でのみ利用できます。機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。
MongoDB、ドキュメントが挿入または更新されるときに、サーバー側で埋め込みを自動生成することもできます。このアプローチでは、埋め込み生成はMongoDB内で発生するため、MCP 構成に Voyage AI APIキーは必要ありません。
MongoDB MCP サーバーは、ドキュメントの埋め込みを自動的に生成する自動埋め込みによるベクトル検索インデックスの管理をサポートしています。自然言語プロンプトによる自動埋め込みでベクトル検索インデックスを作成、削除、検査できます。次の表に主な機能をまとめています。
「自動埋め込み」を参照してください。
ユースケース | 関連ツール | プロンプトの例 |
|---|---|---|
インデックスの管理 |
| "mflix.movies" の 'plot' フィールドに自動エンベッド ベクトル検索インデックスを作成します。voyage-4-large モデルを使用して名前空間を設定します。" |
埋め込みを含むデータの挿入 |
| "次のフィールドを持つこのドキュメントを挿入し、埋め込みを自動生成します..." |
埋め込みを含むクエリ |
| 「mflix.moviesで、'plot'フィールドに自動埋め込みインデックスを使用してベクトル検索クエリを実行します。」 |
Considerations
MongoDB MCP サーバーは事前にフィルタリングするベクトル検索クエリをサポートしています。詳細については、事前フィルターを参照してください。
MCPサーバーはベクトル検索インデックスの quantizationフィールドをサポートしていません。
Performance Advisor ツール
atlas-get-performance-advisor ツールを使用すると、自然言語クエリを介して Performance Advisor の推奨事項にアクセスできます。このツールは、低速クエリを分析し、改善を提案することで、パフォーマンス最適化の機会を特定するのに役立ちます。
低速クエリ分析を実行する際、MongoDB MCP サーバーは低速クエリのサンプルを検索し、上限は 50 クエリに限定します。サンプルには、最適なパフォーマンスと応答時間を確保するために、プロンプトで指定された条件に一致する直近の低速クエリが最大 50 含まれます。
注意
このツールには、Project Read Only以上のアクセス権とM10+クラスターが必要です。
Project Read Only は、サービス アカウントに割り当てられた Atlas プロジェクト レベルのロールを指しますが、データベース ロールを指すものではありません。
ユースケース | プロンプトの例 | Performance Advisor の操作 |
|---|---|---|
低速クエリの分析 |
| |
インデックスに関する提案 |
| |
スキーマのアドバイス |
|
詳細な使用例とサンプル出力については、パフォーマンスの最適化 を参照してください。
Atlas 接続文字列を使用しない接続
このセクションでは、ローカル MCP サーバー atlas-connect-cluster フローについて説明します。Atlas クラスターへの接続文字列を指定せずにローカル MCP サーバーを構成する場合、atlas-connect-cluster ツールは構成された Atlas APIサービス アカウントの認証情報を使用して一時的な データベースユーザー を作成し、クラスターへの接続を確立します。
Remote MCP Server は、独自の接続モデルとセッション モデルに従い、以後のデータベース操作の接続ハンドルを返す別のツール remote-atlas-connect を使用します。
一時データベースユーザーには、次の特徴があります。
ランダムに生成されたユーザー名とパスワード。
デフォルトでは は 4 時間後に期限切れになります。
MCP Server の構成方法に基づいて割り当てられたロール:
readAnyDatabasecreatedelete読み取り専用モードを有効にするか、 、 、updateツール カテゴリを無効にした場合は、 になります。readWriteAnyDatabaseサーバーに完全な権限がある場合。
注意
MongoDB MCP サーバーはユーザー認証情報をメモリにのみ保存し、LLM コンテキストで認証情報を返したり公開したりすることはありません。
読み取りと書き込み保証
MongoDB Atlas マネージド MCP サーバーとLocal MCP for MongoDB MCP サーバーはどちらも、MongoDBデータベースの読み込み操作と書き込み (write)操作に、それぞれsecondaryPreferred 読み込み設定 (read preference)とmajority 書込み保証 (write concern)を使用します。これらの設定を変更または上書きすることはできません。
詳細
特定のツールを無効にし、MCP サーバーを読み取り専用モードに制限する方法については、「ローカルMCP サーバーの設定」を参照してください。
MCP Server の自然言語プロンプトの例については、MongoDB MCP Server の使用例を参照してください。