Learn the "why" behind slow queries and how to fix them in our 2-Part Webinar.
Register now >
Docs Menu
Docs Home
/ /
構成する
Docs Home
/
ツール
/
MongoDB MCP サーバー
/
構成する
Docs Home
/
ツール
/
MongoDB MCP サーバー
/
構成する

MongoDB MCP サーバー構成オプション

MCP Server には、 MongoDBクラスターに接続し、MCP Server の操作を制御するために設定できるさまざまなオプションがあります。コマンドライン、またはオペレーティング システムの環境変数を使用して、 JSON構成ファイルでオプションを設定できます。

オプション リスト

MCP サーバーを構成するには、次の構成オプションを使用します。

重要

MongoDB EnterpriseまたはMongoDB Atlasユーザーで、特定の認証メカニズムが必要な場合は、認証方法の構成オプションについて詳しくは、MongoDB MCP サーバー セキュリティ セクションを参照してください。

CLI オプション名
OS 環境変数名
タイプ
default
説明

allowRequestOverrides

MDB_MCP_ALLOW_REQUEST_OVERRIDES

ブール値

false

ユーザーがリクエストヘッダーとクエリ パラメーターを使用して、リクエストごとに MCP サーバー構成を上書きできるかどうかを示すフラグ。各構成オプションの具体的なオーバーライド動作については、以下の「オーバーライド動作テーブル」を参照してください。

apiClientId

MDB_MCP_API_CLIENT_ID

string

NULLではない

認証用の Atlas APIクライアントID 。

apiClientSecret

MDB_MCP_API_CLIENT_SECRET

string

NULLではない

認証用の Atlas APIクライアントシークレット

config

MDB_MCP_CONFIG

string

NULLではない

JSON構成ファイルへのフルパス。--configコマンドラインオプションを使用するよりも、MDB_MCP_CONFIG 環境変数を使用することを推奨します。

connectionString

MDB_MCP_CONNECTION_STRING

string

NULLではない

データベースに直接接続するための 接続文字列 。

実行時に接続文字列を設定して、クライアントがクラスターに直接接続できるようにします。

重要

--connectionString CLI 引数は非推奨です。代わりに、MDB_MCP_CONNECTION_STRING 環境変数を使用してください。環境変数がオプションでない場合は、最初の位置引数を使用します。

注意

通常、接続資格情報を大規模言語モデルに公開するため、実行時に接続文字列を提供することは避けます。

接続文字列は、クライアントが以前に接続したことがない場合、またはクライアントが以前に接続されていた場合はクライアントが新しいクラスターに接続を切り替えた場合に使用されます。

クライアントが接続ツールまたはスイッチ接続ツールを呼び出すと、クライアントは後続の操作で同じ接続を再利用します。したがって、別の接続に切り替える必要がある場合は、connect または 切り替え 接続ツールを 1 回呼び出す必要があります。

dryRun

MDB_MCP_DRY_RUN

ブール値

false

ドライラン オプションを使用して、MCP サーバーの構成を調べます。ドライランオプションを有効にすると、MCP サーバーは MCP サーバーの構成設定と有効なMongoDB MCP サーバーツールのリストを返します。

ドライラン オプションを有効にするには、構成ファイルまたはコマンドラインで --dryRun を設定するか、MDB_MCP_DRY_RUN オペレーティング システムの環境変数を true に設定します。

詳細については、MCP サーバーのドライ実行モードの有効化を参照してください。

externallyManagedSessions

MDB_MCP_EXTERNALLY_MANAGED_SESSIONS

ブール値

false

クライアントがセッション初期化をスキップできるようにします。有効にすると、クライアントは 自己生成されたセッションIDを使用してツールを直接呼び出すことができます。これらのセッションはサーバー上で暗黙的に作成され、idleTimeoutMS の有効期限が切れるまで有効にされます。これは通常、エージェント コアフレームワークが内部でセッションを管理し、各セッションごとにオンデマンドで MCP サーバーを生成するAWSとの統合に役立ちます。

重要

セッションのセキュリティを強化するには、セッション ID が一意であり、予測できないことを確認します。

loggers

MDB_MCP_LOGGERS

string

disk mcp

MCP サーバーがログを送信するパス。

loggers を次のオプションの 1 つ以上に設定します。

  • diskは、logPath オプションで指定されたパスにあるディスク ファイルにログを書込みます。

  • mcpは、クライアントがロギング および トランスポートプロトコルをサポートしている場合に、ログをAIクライアントに送信します。

  • stderrは、ログを標準エラー出力に送信します。この設定は、デバッグやコンテナで MCP を実行中場合に便利です。

例、 AIクライアントのJSON構成ファイルまたはオペレーティング システムのコマンドラインで loggers を mcp および stderr に設定するには、--loggers mcp stderr を使用します。

MDB_MCP_LOGGERS オペレーティング システムの環境変数を disk と stderr に設定するには、export MDB_MCP_LOGGERS="disk,stderr" を使用します。

ロギング オプションの詳細については、 MongoDB MCP サーバーのトラブルシューティング を参照してください。

logPath

MDB_MCP_LOG_PATH

string

オペレーティング システムによって異なります

MCP サーバー ログを保存するディレクトリ。

注意

MCPサーバーを実行中ユーザーが読み取り/書込み (write) 権限で所有するようにディレクトリをロックダウンします。これにより、他のプロセスがサーバーのディレクトリやファイルにアクセスできなくなります。

ログパスとオペレーティング システムの詳細については、 MongoDB MCP サーバーのトラブルシューティング を参照してください。

disabledTools

MDB_MCP_DISABLED_TOOLS

配列

NULLではない

無効にする MCP ツール名、操作タイプ、またはツール カテゴリの配列。

詳細については、MCP サーバー ツールを無効にする を参照してください。

readOnly

MDB_MCP_READ_ONLY

ブール値

false

書き込み (write) 操作を許可するかどうかを決定するフラグ。クラスター書き込み操作を無効にするには、構成ファイルまたはコマンドラインで --readOnly を設定するか、MDB_MCP_READ_ONLY オペレーティング システムの環境変数を true に設定します。

デフォルトでは、クラスター書込み (write) 操作が許可されています。通常は、常に読み取り専用モードを有効にします。

詳細については、MCP サーバーの読み取り専用モードの有効化 を参照してください。

indexCheck

MDB_MCP_INDEX_CHECK

ブール値

false

クエリにインデックスが必要かどうかを示すフラグ。true の場合、クエリ操作ではインデックスを使用する必要があり、コレクションスキャンを実行するクエリは拒否されます。

詳細については、インデックス チェックの有効化 を参照してください。

telemetry

MDB_MCP_TELEMETRY

string

enabled

使用状況データが MCP サーバーによって収集されているかどうかを示すフラグ。disabled の場合、MCP サーバーの使用状況データコレクションは停止されます。

詳細については、MCP サーバー テレメトリを無効にする を参照してください。

transport

MDB_MCP_TRANSPORT

string

stdio

MCP サーバーとの通信のためのトランスポートプロトコル。

transport を次のいずれかのオプションに設定します。

  • stdioは、デフォルトの です。MCP サーバーとの通信に標準入力と標準出力を使用します。stdio はほとんどのAIクライアントに適しています。

  • http、これにより MCP サーバーとのHTTP通信が可能になります。その後、 HTTPを使用して、Webクライアントから MCP Server と交流したり、特定のHTTP IPポートで MCP Server と通信したりできるようになります。

    警告

    HTTPトランスポートは、適切な認証とセキュリティ対策を実装せず、本番環境での使用には推奨されません。

httpPort

MDB_MCP_HTTP_PORT

integer

3000

MCP サーバーとのHTTP通信のIPポート番号。

httpHost

MDB_MCP_HTTP_HOST

string

127.0.0.1

MCP サーバーとのHTTP通信のIPアドレス。

Streamable HTTPでは、MCP サーバーはデフォルトで localhost (127.0.0.1) にバインドされます。これにより、MCP サーバーは同じコンピューターからの接続のみを受け入れるようになります。

警告

0.0.0.0 にバインディングすると MCP Server がローカル ネットワーク全体に公開されるため、同じネットワーク上の他のデバイスが MCP Server にアクセスできる可能性があります。これはセキュリティ上のリスクであり、データベースコンテキストへの不正アクセスを許可する可能性があります。localhost の外部で MCP サーバーを公開する必要がある場合は、 強力なセキュリティ認証を実装します。

詳細については、リモート接続を参照してください。

httpBodyLimit

MDB_MCP_HTTP_BODY_LIMIT

integer

102400

HTTPリクエスト本文の最大サイズ（バイト単位）。HTTPポートにのみ適用されます。

httpResponseType

MDB_MCP_HTTP_BODY_RESPONSE_TYPE

string

sse

MCPサーバーの応答を制御します。有効な値は sse または json です。

クライアントが sse 接続を確立できない場合は、json 応答タイプの使用を選択できます。json 応答タイプを選択すると、サーバーはクライアントとの通信を開始できません（例: 、通知、ログ）。

healthCheckHost

MDB_MCP_HEALTH_CHECK_HOST

string

NULLではない

別のヘルスチェックHTTPサーバーのホスト アドレス。これは、 KubernetesとDocker がMCP プロセスの正常性をチェックするために使用できるHTTPエンドポイントとなる接続されたデバイスです。HTTPポートにのみ適用されます。

指定した場合、healthCheckPort を設定する必要があります。

healthCheckPort

MDB_MCP_HEALTH_CHECK_PORT

integer

NULLではない

別のヘルスチェックHTTPサーバーのポート番号。これは、 KubernetesとDocker がMCP プロセスの正常性をチェックするために使用できるHTTPエンドポイントとなる接続されたデバイスです。HTTPポートにのみ適用されます。

指定した場合、healthCheckHost を設定する必要があります。

idleTimeoutMs

MDB_MCP_IDLE_TIMEOUT_MS

integer

600000

クライアントが切断するためのアイドル タイムアウト。HTTPトランスポートにのみ適用されます。

notificationTimeoutMs

MDB_MCP_NOTIFICATION_TIMEOUT_MS

integer

540000

クライアントが切断を認識するための通知タイムアウト。HTTPトランスポートにのみ適用されます。

authenticationMechanism

MDB_MCP_AUTHENTICATION_MECHANISM

string

SCRAM-SHA-256

MongoDB MCP サーバー を使用してMongoDB配置に接続するときに使用する認証メカニズム。

SCRAM はMongoDBのデフォルトの認証メカニズムです。他の認証方法を使用して接続するには、次のページを参照してください。

exportsPath

MDB_MCP_EXPORTS_PATH

string

オペレーティング システムによって異なります

エクスポートされたデータファイルを保存するディレクトリ。

注意

MCPサーバーを実行中ユーザーが読み取り/書込み (write) 権限で所有するようにディレクトリをロックダウンします。これにより、エクスポートされたディレクトリやファイルに他のプロセスがアクセスできなくなります。

エクスポート パスとオペレーティング システムの詳細については、 MongoDB MCP サーバーからのデータのエクスポート を参照してください。

exportTimeoutMs

MDB_MCP_EXPORT_TIMEOUT_MS

integer

300000

エクスポートされたデータファイルが MCP サーバーのクリーンアップ プロセスによる削除の対象となる時間（ミリ秒単位）。

exportCleanupIntervalMs

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS

integer

120000

期限切れのエクスポート データ ファイルを削除する MCP Server クリーンアップ プロセスを自動的に実行する間隔（ミリ秒単位）。クリーンアップ プロセスは自動的に実行されます。

previewFeatures

MDB_MCP_PREVIEW_FEATURES

string

NULLではない

有効になっているプレビュー機能のカンマ区切り値。有効な値は search です。

ベクトル検索オプション

重要

MCP でのベクトル検索のサポートは プレビュー機能として利用できます。この機能を有効にするには、MCP 構成で previewFeaturesフラグまたはMDB_MCP_PREVIEW_FEATURES 環境変数を に設定します。search

次のオプションは、MCP サーバーを使用してMongoDB ベクトル検索を操作する場合の MCP サーバーの動作を構成します。

CLI オプション名
OS 環境変数名
タイプ
default
説明

voyageApiKey

MDB_MCP_VOYAGE_API_KEY

string

NULLではない

自動埋め込み生成用のAI APIキーを使用します。

このオプションを構成すると、MCP サーバーは次の埋め込みを自動的に生成します。

  • insert-many ツールを使用して挿入するドキュメント

  • $vectorSearch 集計クエリの queryVector パラメータ

MCP サーバーは、ベクトル検索インデックスを持つフィールドに有効な埋め込みベクトルが含まれていることも検証し、ベクトル検索インデックスの破損を防ぎます。

MongoDB MCPサーバーは次の投票AIモデルをサポートしています。

  • voyage-3-large

  • voyage-3.5

  • voyage-3.5-lite

  • voyage-code-3

投票AIについてさらに学ぶには、投票AI のドキュメントを参照してください。

追加のベクトル検索構成オプションについては、「 ベクトル検索オプション 」を参照してください。

embeddingsValidation

MDB_MCP_EMBEDDINGS_VALIDATION

ブール値

true

埋め込みベクトルが検証されているかどうかを示すフラグ。true に設定すると、埋め込み次元の検証が有効になります。

デフォルトでは 、MCP サーバーはベクトル検索インデックスを持つフィールドに、正しい次元を持つ有効な埋め込みベクトルが含まれていることを検証し、ベクトル検索インデックスの破損を防ぎます。このオプションを無効にすると、検証なしで埋め込みフィールドに未加工の値を挿入できるようになります。

警告

埋め込み検証を無効にすると、ベクトル検索インデックスで使用できない無効な埋め込みを含むドキュメントが生成される可能性があります。

vectorSearchDimensions

MDB_MCP_VECTOR_SEARCH_DIMENSIONS

integer

1024

ベクトル検索埋め込みのデフォルトの次元数。

この値は、ベクトル検索インデックスの作成と埋め込みを検証するときに使用されます。

vectorSearchSimilarityFunction

MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION

string

euclidean

ベクトル検索のデフォルトの類似度関数。を次のいずれかの値に設定します。

  • euclidean: ユークリッド距離

  • cosine: コサイン類似度

  • dotProduct: ドット積類似度

MCPサーバーは、特に指定がない限り、ベクトル検索インデックスを作成するときにこの値をデフォルトとして使用します。詳細については、ベクトル検索のフィールドにインデックスを作成する方法。をご覧ください。

構成オプションの上書き動作

次の表は、各構成オプションの上書き動作を説明したものです。これらの上書き動作は、allowRequestOverrides 構成オプションが true に設定されている場合にのみ適用されます。ユーザーが上書きを禁止する構成オプションを無効にしようとすると、 MCPサーバーは接続を拒否します。

Config Key
動作をオーバーライドする
追加条件

apiBaseUrl

禁止

apiClientId

禁止

apiClientSecret

禁止

allowRequestOverrides

禁止

connectionString

禁止

config

禁止

loggers

禁止

logPath

禁止

disabledTools

merge

既存の構成にあるツールに加えて、無効にします。

confirmationRequiredTools

merge

既存の構成にあるツールに加えて、ツールの確認が必要です。

readOnly

条件付き

既存の false 構成を true にのみ上書きできます。

indexCheck

条件付き

既存の false 構成を true にのみ上書きできます。

telemetry

禁止

transport

禁止

httpPort

禁止

httpHost

禁止

httpHeaders

禁止

healthCheckHost

禁止

healthCheckPort

禁止

idleTimeoutMs

条件付き

既存の構成よりも短いタイムアウトでのみ上書きできます。

notificationTimeoutMs

条件付き

既存の構成よりも短いタイムアウトでのみ上書きできます。

maxBytesPerQuery

禁止

maxDocumentsPerQuery

禁止

exportsPath

禁止

exportTimeoutMs

条件付き

既存の構成よりも短いタイムアウトでのみ上書きできます。

exportCleanupIntervalMs

禁止

atlasTemporaryDatabaseUserLifetimeMs

条件付き

既存の構成よりも短い有効期間でのみ上書きできます。

voyageApiKey

禁止

embeddingsValidation

条件付き

既存の false 構成を true にのみ上書きできます。

vectorSearchDimensions

[readConcern] の上書き

vectorSearchSimilarityFunction

[readConcern] の上書き

previewFeatures

条件付き

既存の構成の機能を無効にするだけで、追加の機能は追加できません。

位置引数

MCP サーバーは、CLI フラグを指定せずに提供できる位置引数を受け入れます。最初の位置引数は、 MongoDBデプロイの接続文字列として解釈されます。

セキュリティ上のベストプラクティスとして、接続文字列を設定するには MDB_MCP_CONNECTION_STRING 環境変数を使用します。 環境変数がオプションでない場合は、最初の位置引数を使用します。（例: ）。

"args": [
   "-y",
   "mongodb-mcp-server",
   "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/",
   "--readOnly"
]

詳細

戻る

構成する

次へ

メソッド

項目一覧