MongoDB MCPサーバーのインストールと設定方法

ソフトウェア開発の絶え間なく進化する状況において、人工知能の統合はもはや未来の概念ではなく、今日の現実です。AIを活用したツールは、開発者にとって不可欠なものとなりつつあり、ワークフローを効率化し、生産性を向上させています。このトレンドを認識し、MongoDBはデータベースとAIの間のギャップを埋める画期的なツール、MongoDB Model Context Protocol (MCP) Serverを導入しました。このチュートリアルでは、MongoDB MCP Serverのインストールと構成に関する包括的なステップバイステップガイドを提供し、開発環境でAIの可能性を最大限に活用できるようにします。

💡

美しいAPIドキュメントを生成する優れたAPIテストツールをお探しですか？

開発チームが最大限の生産性で連携できる統合されたオールインワンプラットフォームをお探しですか？

Apidogはあなたのすべての要求に応え、Postmanをはるかに手頃な価格で置き換えます！

button

MongoDB MCP Serverとは？

MongoDB MCP Serverは、Model Context Protocol (MCP)をサポートする様々なAI搭載クライアントとMongoDBデプロイメントを接続するために設計された強力な新しいツールです。フルマネージドクラウドデータベースであるMongoDB Atlasを使用しているか、自己ホスト型のCommunityまたはEnterprise Advancedエディションを使用しているかに関わらず、MCP Serverは自然言語を使用してデータとのシームレスなインタラクションを可能にします。これにより、お気に入りのAI開発ツール内で、直感的で対話的なコマンドを通じて、単純なデータクエリから複雑な管理タスクまで、幅広いデータベース操作を実行できます。

MCPは、元々Anthropicによって導入されたオープンスタンダードであり、AIエージェントと多様なデータシステム間の標準化された通信レイヤーを作成する能力により、急速に普及しています。このプロトコルを実装することで、MongoDBはそのユーザーがAI主導の開発の最前線にいられるようにしています。MCP Serverは双方向の通信チャネルを促進し、データをクエリできるだけでなく、データベースから最新かつ文脈的に関連性の高い情報を大規模言語モデル（LLM）に提供することも可能にします。これは、データ探索、データベース管理、コンテキスト認識コードの生成などのタスクにとって画期的なことです。

MongoDB MCP Serverは、以下を含むMCPクライアントの成長エコシステムをサポートしています。

Windsurf: MCPサーバーが標準で利用可能なAIネイティブコードエディター。
Cursor: 人気のあるAI搭載コードエディター。
Visual Studio CodeのGitHub Copilot: データベースの力を世界で最も人気のあるIDEにもたらします。
AnthropicのClaude: Claudeデスクトップアプリケーションから直接データベースと対話します。

始めましょう！

前提条件

インストールプロセスに入る前に、いくつかの前提条件が必要です。

Node.jsとnpx: MongoDB MCP ServerはNode.jsアプリケーションであり、通常、Node.jsパッケージランナーであるnpxを使用してインストールおよび実行されます。システムにNode.jsバージョン18以降がインストールされている必要があります。Node.jsのバージョンは、ターミナルまたはコマンドプロンプトを開き、node -vを実行することで確認できます。
MongoDB接続文字列またはAtlas API認証情報: データベースに接続するには、MCP Serverに標準のMongoDB接続文字列またはMongoDB AtlasアカウントのAPI認証情報のいずれかが必要です。
接続文字列: これは、MongoDBインスタンスに接続するための標準的なURI形式です。ユーザー名、パスワード、ホスト、ポート、データベース名が含まれます。
Atlas API認証情報: MongoDB Atlasを使用している場合、必要な権限を持つサービスアカウントを作成し、生成されたAPIクライアントIDとクライアントシークレットを認証に使用できます。この方法は、Atlas固有のツールを使用するために必要です。
MCPクライアント: Cursor、Claude Desktop、またはGitHub Copilot拡張機能付きのVisual Studio Codeなど、サポートされているMCPクライアントのいずれかがインストールされている必要があります。
Docker（オプション）: コンテナ化された環境でMCP Serverを実行したい場合は、DockerとDocker Composeがインストールされている必要があります。これは、ローカルサンドボックステストやローカルのNode.jsインストールを回避するのに特に役立ちます。

インストールと構成

MongoDB MCP Serverのインストールと構成プロセスは、使用しているMCPクライアントによって若干異なります。プロセスの核心は、MCPサーバーの起動方法と通信方法をクライアントに指示するJSON構成をクライアントの設定ファイルに追加することです。

サーバーを実行するための主要なコマンドはnpx -y mongodb-mcp-serverです。-yフラグは、パッケージがまだ存在しない場合にインストールを自動的に確認します。

Cursorでの設定

Cursorは、急速に人気が高まっているAIファーストのコードエディターです。CursorでMongoDB MCP Serverを設定する方法は次のとおりです。

Cursorの設定を開く: Cursorを起動し、ウィンドウの右上隅にある歯車アイコンをクリックして設定を開きます。
MCPセクションに移動: 左側の設定パネルで、「MCP」をクリックします。
新しいグローバルMCPサーバーを追加: 「Add new global MCP server」ボタンをクリックします。これにより、JSON構成ファイルが開かれます。
構成を入力: 次のJSON構成をファイルにコピー＆ペーストします。接続の詳細に合わせてこれをカスタマイズする必要があります。

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Atlas API認証情報の代わりに接続文字列を使用している場合、構成は次のようになります。JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

構成を保存: ファイルを保存します。これでCursorは新しいMongoDB MCP Serverを使用できるようになります。

サーバーが構成されたら、Cursor内で自然言語を使用してデータベースと対話できるようになります。Atlas API認証情報を使用した場合、無料クラスターの作成、アクセスリストの管理、データベースユーザーの作成など、Atlas固有の豊富なツールセットにアクセスできます。接続文字列を使用した場合、データベースのリスト表示やコレクションのリスト表示、インデックスの管理、CRUD（作成、読み取り、更新、削除）操作の実行など、データベース管理用のツールにアクセスできます。

Claude Desktopでの設定

AnthropicのClaudeユーザーであれば、MongoDB MCP ServerをClaudeデスクトップアプリケーションに直接統合できます。

構成ファイルを開く: Claude Desktopアプリケーションを起動し、「Settings > Developer > Edit Config」に移動します。これにより、claude_desktop_config.jsonファイルがデフォルトのテキストエディターで開かれます。このファイルの場所は通常次のとおりです。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

MCPサーバー構成を追加: JSONファイルのmcpServersオブジェクトに次の構成を追加します。

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

プレースホルダーの接続文字列を実際の接続文字列に置き換えてください。
Claude Desktopを再起動: Claude Desktopアプリケーションを閉じて再起動します。
サーバーを確認: Claude Desktopのハンマーアイコンをクリックします。MongoDB MCP Serverが利用可能なツールとしてリスト表示されているはずです。

Visual Studio CodeでGitHub Copilotを使用して設定する

Visual Studio Codeを使用する何百万もの開発者にとって、MongoDB MCP ServerはGitHub Copilotと統合して、お気に入りのIDEに自然言語でのデータベースインタラクションをもたらすことができます。

コマンドパレットを開く: VS Codeを開き、Ctrl+Shift+P（macOSではCmd+Shift+P）を押してコマンドパレットを開きます。
新しいMCPサーバーを追加: コマンドパレットに「mcp」と入力し、「MCP: Add Servers」を選択します。
コマンド標準I/Oを選択: サーバータイプとして「Command Standard I/O」を選択します。
コマンドを入力: コマンドnpx -y mongodb-mcp-serverを入力し、サーバーに例えば「mongodb」のような名前を付けます。
settings.jsonで構成: これにより、settings.jsonファイルが開かれます。ここで、引数と環境変数を追加できます。例えば、接続文字列を使用する場合：

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

または、Atlas API認証情報を使用する場合：JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

サーバーを起動: settings.jsonファイルでサーバー名の上に表示される「Start」ボタンをクリックするか、コマンドパレットを開いて「MCP: List Servers」を検索し、サーバーを選択してから「Start Server」を選択することで、サーバーを起動できます。

サーバーが実行されると、GitHub Copilotエージェントモードを使用してMongoDB Atlas環境と対話できます。プロジェクトのリスト表示、新しいクラスターの作成、ユーザーの管理など、VS Code内からすべてを実行するように依頼できます。

高度な構成

MongoDB MCP Serverは、特定のニーズに合わせて動作を調整するためのいくつかの高度な構成オプションを提供します。

読み取り専用モード

特に本番データベースに接続する場合、安全性を高めるために、サーバーを読み取り専用モードで実行できます。これにより、ドキュメントの作成、更新、削除などの書き込み操作が防止されます。コマンドライン引数を使用して読み取り専用モードを有効にできます。

npx mongodb-mcp-server --readOnly

または、環境変数を設定することで：

export MDB_MCP_READ_ONLY=true

特定のツールの無効化

サーバーの機能を制限するために特定のツールを無効にできます。これはセキュリティや利用可能なコマンドを簡素化するのに役立ちます。--disabledToolsコマンドライン引数を使用し、その後にツール名のスペース区切りリストを続けることでツールを無効にできます。

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

あるいは、MDB_MCP_DISABLED_TOOLS環境変数にツール名のカンマ区切りリストを指定して使用することもできます。

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

テレメトリ

デフォルトでは、MongoDB MCP Serverは製品の改善に役立てるために匿名使用データを収集します。これを無効にしたい場合は、--telemetry disabledコマンドライン引数またはMDB_MCP_TELEMETRY=disabled環境変数を使用できます。

Dockerでのインストール

コンテナ化された環境を好む人のために、MongoDB MCP ServerはDockerコンテナ内で実行できます。これにより隔離が提供され、ローカルのNode.jsインストールが不要になります。

接続文字列を使用してサーバーを実行するには：

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

Atlas API認証情報を使用して実行するには：

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

次に、MCPクライアントをnpxの代わりにdockerコマンドを使用するように構成します。例えば、Claude Desktopでは：JSON

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

結論

MongoDB MCP Serverは、AIとデータベースの統合における重要な一歩を表しています。AIクライアントがMongoDBと対話するための標準化された方法を提供することで、開発者にとって可能性の世界が開かれます。自然言語でのクエリやデータ探索から、AI支援によるデータベース管理やコード生成まで、MCP Serverは現代の開発者のツールキットにおいて不可欠なツールとなるでしょう。

このチュートリアルでは、MongoDB MCP Serverの使用開始に関する包括的なガイドを提供しました。これらの手順に従うことで、MongoDBデプロイメントをお気に入りのAIツールにすばやく簡単に接続し、AIを活用した開発のメリットを享受し始めることができます。これは新しく進化しているテクノロジーであるため、最新のアップデートと機能については、公式のMongoDBドキュメントとGitHubリポジトリを必ず確認してください。データベースインタラクションの未来はここにあり、MongoDB MCP Serverを使用すれば、あなたは最先端にいます。

💡

button