Docs Menu
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クライアントシークレット

connectionString

MDB_MCP_CONNECTION_STRING

string

NULLではない

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

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

重要

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

注意

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

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

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

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 サーバーを公開する必要がある場合は、 強力なセキュリティ認証を実装します。

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

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 クリーンアップ プロセスを自動的に実行する間隔（ミリ秒単位）。クリーンアップ プロセスは自動的に実行されます。

位置引数

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

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

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

詳細

戻る

構成する

次へ

メソッド

項目一覧