MongoDB MCP Server

MongoDB データベースおよび MongoDB Atlas と対話するための Model Context Protocol サーバー。

📚 目次

• 🚀 はじめに

  • 前提条件

  • セットアップ

    • クイックスタート

• 🛠️ サポートされているツール

  • MongoDB Atlas ツール

  • MongoDB データベースツール

• ⚙️ 設定

  • 設定オプション

  • Atlas API アクセス

  • 設定方法

    • 環境変数

    • コマンドライン引数

    • MCP クライアント設定

• 🤝 コントリビューション

前提条件

• Node.js (v20.10.0 以降)

node -v

• MongoDB 接続文字列または Atlas API 認証情報。設定しない限りサーバーは起動しません。

  • Atlas ツールを使用するには Service Accounts Atlas API 認証情報 が必要です。MongoDB Atlas でサービスアカウントを作成し、その認証情報を認証に使用できます。詳細は Atlas API アクセス を参照してください。

  • MongoDB 接続文字列をお持ちの場合は、それを使用して MongoDB インスタンスに直接接続できます。

セットアップ

クイックスタート

注: Atlas API 認証情報を使用する場合は、サービスアカウントに必要な最小限の権限のみを必ず割り当ててください。詳細は Atlas API 権限 を参照してください。

ほとんどの MCP クライアントでは、MCP サーバーを追加するために設定ファイルの作成または変更が必要です。

注: 設定ファイルの構文はクライアントによって異なる場合があります。最新の期待される構文については、以下のリンクを参照してください:

• Windsurf:https://docs.windsurf.com/windsurf/mcp

• VSCode: https://code.visualstudio.com/docs/copilot/chat/mcp-servers

• Claude Desktop: https://modelcontextprotocol.io/quickstart/user

• Cursor: https://docs.cursor.com/context/model-context-protocol

オプション 1: 接続文字列の引数

接続文字列を引数で渡すことができます。有効なユーザー名とパスワードを使用してください。

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb://localhost:27017/myDatabase"
      ]
    }
  }
}

注: 接続文字列は、ローカルインスタンスでも Atlas クラスターでも、任意の MongoDB クラスターに接続するように設定できます。

オプション 2: Atlas API 認証情報の引数

Atlas API サービスアカウントの認証情報を使用します。Atlas API アクセス セクションのすべての手順に従う必要があります。

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--apiClientId",
        "your-atlas-service-accounts-client-id",
        "--apiClientSecret",
        "your-atlas-service-accounts-client-secret"
      ]
    }
  }
}

オプション 3: コマンド引数を使用したスタンドアロンサービス

npx コマンドでサーバーを起動します:

 npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret"

• 引数の完全なリストについては 設定オプション を参照してください

• Atlas サービスアカウントの認証情報の設定については Atlas API アクセス を参照してください

オプション 4: 環境変数を使用したスタンドアロンサービス

 npx -y mongodb-mcp-server

設定ファイルで環境変数を使用するか、環境変数を設定して npx でサーバーを実行できます。

• MCP ファイル内の環境変数による接続文字列 例

• MCP ファイル内の環境変数による Atlas API 認証情報 例

オプション 5: Docker の使用

MongoDB MCP Server は Docker コンテナで実行できます。これにより分離が提供され、ローカルに Node.js をインストールする必要がありません。

環境変数で実行する

MongoDB 接続文字列または Atlas API 認証情報のいずれかを指定できます:

オプション A: 設定なし

docker run --rm -i \
  mongodb/mongodb-mcp-server:latest

オプション B: MongoDB 接続文字列あり

docker run --rm -i \
  -e MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" \
  mongodb/mongodb-mcp-server:latest

オプション C: Atlas API 認証情報あり

docker run --rm -i \
  -e MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id" \
  -e MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret" \
  mongodb/mongodb-mcp-server:latest

MCP 設定ファイル内の Docker

オプションなし:

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "mongodb/mongodb-mcp-server:latest"]
    }
  }
}

接続文字列あり:

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_CONNECTION_STRING=mongodb+srv://username:password@cluster.mongodb.net/myDatabase",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Atlas API 認証情報あり:

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-service-accounts-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-service-accounts-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

🛠️ サポートされているツール

ツール一覧

MongoDB Atlas ツール

• atlas-list-orgs - MongoDB Atlas の組織を一覧表示します

• atlas-list-projects - MongoDB Atlas のプロジェクトを一覧表示します

• atlas-create-project - 新しい MongoDB Atlas プロジェクトを作成します

• atlas-list-clusters - MongoDB Atlas のクラスターを一覧表示します

• atlas-inspect-cluster - 特定の MongoDB Atlas クラスターを検査します

• atlas-create-free-cluster - 無料の MongoDB Atlas クラスターを作成します

• atlas-connect-cluster - MongoDB Atlas クラスターに接続します

• atlas-inspect-access-list - MongoDB Atlas クラスターにアクセスできる IP/CIDR 範囲を検査します

• atlas-create-access-list - MongoDB Atlas クラスターの IP/CIDR アクセスリストを設定します

• atlas-list-db-users - MongoDB Atlas のデータベースユーザーを一覧表示します

• atlas-create-db-user - MongoDB Atlas のデータベースユーザーを作成します

• atlas-list-alerts - プロジェクトの MongoDB Atlas アラートを一覧表示します

注: Atlas ツールは、設定 セクションで認証情報を設定した場合にのみ利用できます。

MongoDB データベースツール

• connect - MongoDB インスタンスに接続します

• find - MongoDB コレクションに対して find クエリを実行します

• aggregate - MongoDB コレクションに対して集計を実行します

• count - MongoDB コレクション内のドキュメント数を取得します

• insert-one - MongoDB コレクションに単一のドキュメントを挿入します

• insert-many - MongoDB コレクションに複数のドキュメントを挿入します

• create-index - MongoDB コレクションのインデックスを作成します

• update-one - MongoDB コレクション内の単一のドキュメントを更新します

• update-many - MongoDB コレクション内の複数のドキュメントを更新します

• rename-collection - MongoDB コレクションの名前を変更します

• delete-one - MongoDB コレクションから単一のドキュメントを削除します

• delete-many - MongoDB コレクションから複数のドキュメントを削除します

• drop-collection - MongoDB データベースからコレクションを削除します

• drop-database - MongoDB データベースを削除します

• list-databases - MongoDB 接続のすべてのデータベースを一覧表示します

• list-collections - 指定されたデータベースのすべてのコレクションを一覧表示します

• collection-indexes - コレクションのインデックスを説明します

• collection-schema - コレクションのスキーマを説明します

• collection-storage-size - コレクションのサイズを MB 単位で取得します

• db-stats - MongoDB データベースに関する統計情報を返します

設定

MongoDB MCP Server は複数の方法で設定できます。優先順位は以下のとおりです（高い順）:

1. コマンドライン引数

2. 環境変数

設定オプション

ログパス

デフォルトのログの場所は以下のとおりです:

• Windows: %LOCALAPPDATA%\mongodb\mongodb-mcp\.app-logs

• macOS/Linux: ~/.mongodb/mongodb-mcp/.app-logs

無効化されたツール

disabledTools オプションを使用すると、特定のツールまたはツールのカテゴリを無効化できます。このオプションは文字列の配列を受け入れます。各文字列は、ツール名、操作タイプ、またはカテゴリを指定できます。

配列の構成方法は、使用する設定方法のタイプによって異なります:

• 環境変数設定の場合、カンマ区切りの文字列を使用します: export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"。

• コマンドライン引数設定の場合、スペース区切りの文字列を使用します: --disabledTools create update delete atlas collectionSchema。

ツールのカテゴリ:

• atlas - MongoDB Atlas ツール(クラスターの一覧表示、クラスターの作成など)。

• mongodb - MongoDB データベースツール(find、aggregate など)。

操作タイプ:

• create - リソースを作成するツール(クラスターの作成、ドキュメントの挿入など)。

• update - リソースを更新するツール(ドキュメントの更新、コレクションの名前変更など)。

• delete - リソースを削除するツール(ドキュメントの削除、コレクションの削除など)。

• read - リソースを読み取るツール(find、aggregate、クラスターの一覧表示など)。

• metadata - メタデータを読み取るツール(データベースの一覧表示、コレクションの一覧表示、コレクションスキーマなど)。

読み取り専用モード

readOnly 設定オプションを使用すると、MCP サーバーを「read」および「metadata」操作タイプのツールのみを使用するように制限できます。有効にすると、「create」、「update」、「delete」の操作タイプを持つすべてのツールはサーバーに登録されません。

これは、データやインフラストラクチャへの変更を許可せずに、分析目的で MongoDB データへのアクセスを提供したいシナリオで役立ちます。

読み取り専用モードは、次の方法で有効にできます:

• 環境変数: export MDB_MCP_READ_ONLY=true

• コマンドライン引数: --readOnly

読み取り専用モードがアクティブな場合、この制限により登録が阻止されたツールを示すメッセージがサーバーログに表示されます。

テレメトリ

telemetry 設定オプションを使用すると、テレメトリ収集を無効化できます。有効にすると、MCP サーバーは使用状況データを収集し、MongoDB に送信します。

テレメトリは、次の方法で無効化できます:

• 環境変数: export MDB_MCP_TELEMETRY=disabled

• コマンドライン引数: --telemetry disabled

• DO_NOT_TRACK 環境変数: export DO_NOT_TRACK=1

Atlas API アクセス

Atlas API ツールを使用するには、MongoDB Atlas でサービスアカウントを作成する必要があります:

ℹ️ 注: 各 Atlas 操作に必要な最小権限の詳細については、以下の Atlas API 権限 セクションを参照してください。

1. サービスアカウントを作成する:

   • cloud.mongodb.com で MongoDB Atlas にログインします

   • Access Manager > Organization Access に移動します

   • Add New > Applications > Service Accounts をクリックします

   • サービスアカウントの名前、説明、有効期限を入力します(例:「MCP、MCP Server Access、7 days」)

   • ユースケースに必要な最小限の権限のみを割り当てます。

     • 詳細については Atlas API 権限 を参照してください。

   • 「Create」をクリックします

サービスアカウントの詳細については、MongoDB Atlas ドキュメント を確認してください。

2. クライアント認証情報を保存する:

   • 作成後、Client ID と Client Secret が表示されます

   • 重要: Client Secret は再度表示されないため、すぐにコピーして保存してください

3. アクセスリストエントリを追加する:

   • API アクセスリストに IP アドレスを追加します

4. MCP サーバーを設定する:

   • 以下の設定方法のいずれかを使用して、apiClientId と apiClientSecret を設定します

Atlas API 権限

セキュリティ警告: Organization Owner ロールの付与はほとんど必要なく、セキュリティリスクとなる可能性があります。ユースケースに必要な最小限の権限のみを割り当ててください。

クイックリファレンス: 操作ごとに必要なロール

• ほとんどの操作では、プロジェクトレベルのロールを優先します。管理または表示が必要な特定のプロジェクトにのみ割り当ててください。

• 組織内のすべてのプロジェクトと設定に対する完全な管理制御が必要な場合を除き、Organization Owner は避けてください。

ロールとその権限の完全なリストについては、Atlas ユーザーロールのドキュメント を参照してください。

設定方法

環境変数

プレフィックス MDB_MCP_ に続けてオプション名を大文字のアンダースコア区切りで使用して、環境変数を設定します:

# Set Atlas API credentials (via Service Accounts)
export MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id"
export MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret"

# Set a custom MongoDB connection string
export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase"

export MDB_MCP_LOG_PATH="/path/to/logs"

MCP 設定ファイルの例

環境変数を使用した接続文字列

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      }
    }
  }
}

環境変数を使用した Atlas API 認証情報

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server"],
      "env": {
        "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id",
        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret"
      }
    }
  }
}

コマンドライン引数

サーバーの起動時に、設定オプションをコマンドライン引数として渡します:

npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs

MCP 設定ファイルの例

コマンドライン引数を使用した接続文字列

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
      ]
    }
  }
}

コマンドライン引数を使用した Atlas API 認証情報

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--apiClientId",
        "your-atlas-service-accounts-client-id",
        "--apiClientSecret",
        "your-atlas-service-accounts-client-secret"
      ]
    }
  }
}

🤝 コントリビューション

コントリビューションに興味がありますか? 素晴らしい! コードコントリビューション、標準、新しいツールの追加、トラブルシューティング情報に関するガイドラインについては、コントリビューションガイド を確認してください。