MCP MongoDB サーバー

NPMバージョン NPMダウンロード NPMライセンス鍛冶屋のバッジ

LLMがMongoDBデータベースとやり取りできるようにするモデルコンテキストプロトコルサーバー。このサーバーは、標準化されたインターフェースを介してコレクションスキーマを検査し、MongoDB操作を実行する機能を提供します。

デモ

MCP MongoDB サーバーデモ | Claude Desktop

Related MCP server: MongoDB MCP Server for LLMs

主な特徴

スマートなオブジェクトID処理

文字列IDとMongoDB ObjectId間のインテリジェントな変換
objectIdModeパラメータで設定可能:
- "auto" : フィールド名に基づいて変換します（デフォルト）
- "none" : 変換なし
- "force" : すべての文字列IDフィールドをObjectIdに強制する

柔軟な構成

環境変数:
- MCP_MONGODB_URI : MongoDB 接続 URI
- MCP_MONGODB_READONLY : 「true」に設定すると読み取り専用モードが有効になります
コマンドラインオプション:
- --read-onlyまたは-r : 読み取り専用モードで接続する

読み取り専用モード

書き込み操作（更新、挿入、インデックス作成）に対する保護
最適なパフォーマンスを得るために MongoDB のセカンダリ読み取り設定を使用します
実稼働データベースに安全に接続するのに最適

MongoDB 操作

読み取り操作:
- オプションの実行プラン分析によるドキュメントのクエリ
- 集計パイプラインを実行する
- 条件に一致するドキュメントをカウントする
- コレクションスキーマ情報を取得する
書き込み操作（読み取り専用モードではない場合）:
- ドキュメントの更新
- 新しいドキュメントを挿入する
- インデックスを作成する

LLM統合

LLMインタラクション強化のためのコレクション完了
コンテキスト理解を向上させるスキーマ推論
データの洞察を得るための収集分析

インストール

グローバルインストール

npm install -g mcp-mongo-server

開発のために

# Clone repository
git clone https://github.com/kiliczsh/mcp-mongo-server.git
cd mcp-mongo-server

# Install dependencies
npm install

# Build
npm run build

# Development with auto-rebuild
npm run watch

使用法

基本的な使い方

# Start server with MongoDB URI
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database

# Connect in read-only mode
npx -y mcp-mongo-server mongodb://muhammed:kilic@localhost:27017/database --read-only

環境変数

環境変数を使用してサーバーを構成できます。これは、CI/CD パイプライン、Docker コンテナ、またはコマンド引数で接続の詳細を公開したくない場合に特に便利です。

# Set MongoDB connection URI
export MCP_MONGODB_URI="mongodb://muhammed:kilic@localhost:27017/database"

# Enable read-only mode
export MCP_MONGODB_READONLY="true"

# Run server (will use environment variables if no URI is provided)
npx -y mcp-mongo-server

Claude Desktop 構成で環境変数を使用する:

{
  "mcpServers": {
    "mongodb-env": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server"
      ],
      "env": {
        "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database",
        "MCP_MONGODB_READONLY": "true"
      }
    }
  }
}

Docker で環境変数を使用する:

# Build
docker build -t mcp-mongo-server .

# Run
docker run -it -d -e MCP_MONGODB_URI="mongodb://muhammed:kilic@localhost:27017/database" -e MCP_MONGODB_READONLY="true" mcp-mongo-server

# or edit docker-compose.yml and run
docker-compose up -d

Claude Desktopとの統合

手動設定

Claude Desktop の設定ファイルにサーバー設定を追加します。

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

コマンドライン引数のアプローチ:

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database",
        "--read-only"
      ]
    }
  }
}

環境変数アプローチ:

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server"
      ],
      "env": {
        "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database"
      }
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server"
      ],
      "env": {
        "MCP_MONGODB_URI": "mongodb://muhammed:kilic@localhost:27017/database",
        "MCP_MONGODB_READONLY": "true"
      }
    }
  }
}

GitHub パッケージの使用法:

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "github:kiliczsh/mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    },
    "mongodb-readonly": {
      "command": "npx",
      "args": [
        "-y",
        "github:kiliczsh/mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database",
        "--read-only"
      ]
    }
  }
}

WindsurfとCursorとの統合

MCP MongoDB サーバーは、Claude Desktop と同様に Windsurf および Cursor で使用できます。

ウィンドサーフィンの構成

Windsurf 構成にサーバーを追加します。

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    }
  }
}

カーソルの設定

カーソルの場合は、設定にサーバー構成を追加します。

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-mongo-server",
        "mongodb://muhammed:kilic@localhost:27017/database"
      ]
    }
  }
}

Claude Desktop 構成に示されているのと同じパターンに従って、Windsurf と Cursor の両方で環境変数アプローチを使用することもできます。

自動インストール

Smitheryの使用:

npx -y @smithery/cli install mcp-mongo-server --client claude

mcp-get の使用:

npx @michaellatman/mcp-get@latest install mcp-mongo-server

利用可能なツール

クエリ操作

query : MongoDBクエリを実行する

{
  collection: "users",
  filter: { age: { $gt: 30 } },
  projection: { name: 1, email: 1 },
  limit: 20,
  explain: "executionStats"  // Optional
}

集計: 集計パイプラインを実行する

{
  collection: "orders",
  pipeline: [
    { $match: { status: "completed" } },
    { $group: { _id: "$customerId", total: { $sum: "$amount" } } }
  ],
  explain: "queryPlanner"  // Optional
}

count : 一致する文書を数える

{
  collection: "products",
  query: { category: "electronics" }
}

書き込み操作

更新: ドキュメントを変更する

{
  collection: "posts",
  filter: { _id: "60d21b4667d0d8992e610c85" },
  update: { $set: { title: "Updated Title" } },
  upsert: false,
  multi: false
}

挿入: 新しいドキュメントを追加する

{
  collection: "comments",
  documents: [
    { author: "user123", text: "Great post!" },
    { author: "user456", text: "Thanks for sharing" }
  ]
}

createIndex : コレクションのインデックスを作成する

{
  collection: "users",
  indexes: [
    {
      key: { email: 1 },
      unique: true,
      name: "email_unique_idx"
    }
  ]
}

システム操作

serverInfo : MongoDB サーバーの詳細を取得する
```
{
  includeDebugInfo: true  // Optional
}
```

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。MCPインスペクターを使用すると、より詳細な情報を得ることができます。

npm run inspector

これにより、ブラウザでデバッグツールにアクセスするための URL が提供されます。

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。

MongoDB