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
説明

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 サーバーのドライ実行モードの有効化を参照してください。

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 サーバー ログを保存するディレクトリ。

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

disabledTools

MDB_MCP_DISABLED_TOOLS

配列

NULLではない

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

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

readOnly

MDB_MCP_READ_ONLY

ブール値

false

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

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

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

indexCheck

MDB_MCP_INDEX_CHECK

ブール値

false

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

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

telemetry

MDB_MCP_TELEMETRY

string

enabled

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ポートにのみ適用されます。

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

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

exportsPath

MDB_MCP_EXPORTS_PATH

string

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

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

エクスポート パスとオペレーティング システムの詳細については、 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 でのベクトル検索のサポートは previewFeaturesMDB_MCP_PREVIEW_FEATURESsearchプレビュー機能として利用できます。この機能を有効にするには、MCP 構成で フラグまたは 環境変数を に設定します。

次のオプションは、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 のドキュメントを参照してください。

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

disableEmbeddingsValidation

MDB_MCP_DISABLE_EMBEDDINGS_VALIDATION

ブール値

false

true に設定すると、埋め込み次元の検証が無効になります。

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

警告

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

vectorSearchDimensions

MDB_MCP_VECTOR_SEARCH_DIMENSIONS

integer

1024

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

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

vectorSearchSimilarityFunction

MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION

string

euclidean

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

  • euclidean: ユークリッド距離

  • cosine: コサイン類似度

  • dotProduct: ドット積類似度

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

位置引数

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

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

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

詳細

戻る

構成する

次へ

メソッド

項目一覧