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