Docs Menu
Docs Home
/ /

MongoDB MCP サーバー ツール

MongoDB MCP サーバーを使用すると、 MCP をサポートするAIクライアントからの自然言語クエリを使用してMongoDBクラスターを操作できます。このページでは MCP Server ツールについて説明します。

MongoDB MCPサーバーは次のツール カテゴリを提供します。

  • Atlas ツール。組織、プロジェクト、クラスター、データベースユーザーアカウント、パフォーマンス推奨事項の取得など、Atlas システム リソースに対して操作を実行します。

  • ローカル Atlas ツール: ローカル Atlas 配置を一覧表示、接続、作成、削除できます。

  • データベース ツール。ドキュメントの挿入、更新、削除などの操作と、クエリや集計パイプラインの実行を実行します。

Atlas ツールは、MongoDB MCP サーバー構成に示されているように Atlas API認証情報を設定している場合にのみ使用できます。

次の表では、Atlas ツールについて説明しています。

MCP Server Atlas ツール名
説明

atlas-list-orgs

Atlas 組織の一覧を返します。

atlas-list-projects

Atlas プロジェクトの一覧を返します。

atlas-create-project

新しい Atlasプロジェクトを作成します。

atlas-list-clusters

Atlas クラスターの一覧を返します。

atlas-inspect-cluster

特定の Atlas クラスターに関する情報を返します。

atlas-create-free-cluster

無料の Atlas クラスターを作成します。

atlas-connect-cluster

構成されたサービス アカウントを使用して Atlas クラスターに接続します。

接続文字列を指定せずに MCPサーバーを構成した場合、このツールは接続を確立するためのランダムなパスワードを持つ一時データベースユーザーを作成します。詳細については、「 ツールの詳細 」を参照してください。

atlas-inspect-access-list

Atlas クラスターにアクセスできる IPと CIDR 範囲に関する情報を返します。

atlas-create-access-list

Atlas クラスターのIPと CIDR アクセス リストを設定します。

atlas-list-db-users

Atlasデータベースユーザーの一覧を返します。

atlas-create-db-user

Atlasデータベースユーザーを作成します。

atlas-list-alerts

Atlasプロジェクトのアラートの一覧を返します。

atlas-list-performance-advisor

Atlas クラスターの Performance AdvisorProject Read Only の推奨事項を返します。推奨インデックス、削除インデックス、低速クエリ ログ、スキーマ提案の操作をサポートします。 以上のアクセス権が必要です。

詳細については、 Performance Advisor ツール を参照してください。

MongoDB Atlas のローカル配置で MCP サーバーを使用できます。 Atlas のローカル配置の概要については、「 Atlas 配置の作成 」を参照してください。

次の表では、ローカル Atlas ツールについて説明します。

MCP サーバー ローカル Atlas ツール名
説明

atlas-local-list-deployments

Atlas のローカル配置を一覧表示します。

atlas-local-create-deployment

Atlas のローカル配置を作成します。このツールを実行するには、読み取り専用モードを無効にする必要があります。

atlas-local-connect-deployment

Atlas のローカル配置に接続します。

atlas-local-delete-deployment

Atlas のローカル配置を削除します。このツールを実行するには、読み取り専用モードを無効にする必要があります。

ローカル Atlas ツールを実行する例については、「 ローカル Atlas 配置 」を参照してください。

次の表では、データベースツールについて説明しています。

MCP Server データベース ツール名
説明

connect

クラスターに接続します。

find

データベースクエリ を実行します。

aggregate

集計パイプラインを実行します。

count

コレクション内のドキュメントの数を返します。

insert-one

コレクションに単一のドキュメントを追加します。

insert-many

コレクションに複数の ドキュメント を追加します。

create-index

コレクションにインデックスを追加します。

update-one

コレクションの 1 つのドキュメントを変更します。

update-many

コレクションの複数のドキュメントを変更します。

rename-collection

コレクションの名前を変更します。

delete-one

コレクションから 1 つのドキュメントを削除します。

delete-many

コレクションから複数のドキュメントを排除します。

drop-collection

データベースからコレクションを削除します。

drop-database

データベースを削除します。

list-databases

現在の接続で使用可能なすべてのデータベースの一覧を返します。

list-collections

データベース内のコレクションの一覧を返します。

collection-indexes

コレクションのインデックスに関する情報を返します。

collection-schema

コレクションスキーマ情報を返します。

collection-storage-size

コレクションのサイズをメガバイト単位で返します。

db-stats

データベースの統計情報を返します。

export

クエリまたは集計パイプラインの結果をJSON形式で、 MCP Server を実行するコンピューター上のファイルに保存します。また、 AIクライアントアプリケーションの exported-dataリソースからアクセスできます。

特定の MCP ツールに関する追加情報については、次のセクションを参照してください。

Atlas クラスターへの接続文字列を指定せずに MCPサーバーを構成した場合、atlas-connect-cluster ツールは、構成された Atlas APIサービス アカウントの認証情報を使用してクラスターへの接続を確立するための一時データベースユーザーを作成します。

一時データベースユーザーには、次の特徴があります。

  • ランダムに生成されたユーザー名とパスワード。

  • 12 時間後に自動的に期限切れになります。

  • MCP Server の構成方法に基づいて割り当てられたロール:

    • readAnyDatabasecreatedelete読み取り専用モードを有効にするか、 、 、update ツール カテゴリを無効にした場合は、 になります。

    • readWriteAnyDatabase サーバーに完全な権限がある場合。

注意

ユーザー認証情報は MCP サーバーのメモリにのみ保存され、LM コンテキストに返されたり公開されたりすることはありません。

atlas-list-performance-advisorツールを使用すると、自然言語クエリを介して Performance Advisor の推奨事項にアクセスできます。このツールは、低速クエリを分析し、改善を提案することで、パフォーマンス最適化の機会を特定するのに役立ちます。

低速クエリ分析を実行する際、 MongoDB MCP Server は低速クエリのサンプルを取得し、上限は 50 クエリに限定します。サンプルには、最適なパフォーマンスと応答時間を確保するために、プロンプトで指定された条件に一致する直近の低速クエリが最大 50 含まれます。

注意

このツールには アクセス 以上とProject Read Only M10 以上のクラスターが必要です。--readonly フラグで使用できます。

ユースケース
プロンプトの例
Performance Advisor の操作

低速クエリの分析

Show me my slow queries

What is slowing down my cluster?

Show me queries that are longer than 5 seconds

Show me slow writes in the website.users namespace

インデックスに関する提案

Are there any indexes I should create to improve performance?

What indexes do you recommend I drop?

スキーマのアドバイス

Show schema recommendations for my cluster

Help me optimize my database schema

詳細な使用例とサンプル出力については、「 パフォーマンスの最適化 」を参照してください。

特定のツールを無効にして MCP サーバーを 読み取り専用モードに制限するには、 MongoDB MCP サーバーの構成 を参照してください。

MCP Server の自然言語プロンプトの例については、MongoDB MCP Server の使用例を参照してください。

戻る

トラブルシューティング

項目一覧