Mongo MCP

🚀 🗄️ MongoDB MCP サーバー for LLM

このサーバーは、大型言語モデル（LLM）がMongoDBデータベースと直接対話できるようにする、モデルコンテキストプロトコル（MCP）サーバーです。自然言語でコレクションをクエリし、スキーマをチェックし、データを分析し、管理することができます。

✨ 主な機能

• 🔍 コレクションスキーマのチェック
• 📊 ドキュメントのクエリとフィルタリング
• 📈 インデックス管理
• 📝 ドキュメント操作（挿入、更新、削除）

🎥 デモビデオ

https://github.com/user-attachments/assets/2389bf23-a10d-49f9-bca9-2b39a1ebe654

🚀 クイックスタート

始めるには、MongoDB接続URLを見つけ、この設定をClaude Desktopの設定ファイルに追加します。

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

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": [
        "mongo-mcp",
        "mongodb://<username>:<password>@<host>:<port>/<database>?authSource=admin"
      ]
    }
  }
}

Smithery経由でのインストール

Smithery を通じてインストールするには、以下のコマンドを実行します。

smithery install --package mongo-mcp

その後、smithery.toml に以下を追加します。

[mongo-mcp]
command = "node"
args = ["index.js"]

📦 インストール

前提条件

• Node.js（バージョン18+）
• npm または yarn
• Docker（オプションのサンドボックス環境用）

依存関係のインストール

以下のコマンドを使用して、プロジェクトの依存関係をインストールします。

npm install

または

yarn install

サーバーの起動

MCPサーバーを起動するには、以下を実行します。

npm start

または

yarn start

🔧 テスト環境の設定

Dockerを使用したMongoDBの起動

以下のコマンドを使用して、Docker内でMongoDBを起動できます。

docker run --name mcp-mongo -d mongo:latest

その後、以下のコマンドでMongoDBインスタンスに接続できます。

mongo --host localhost --port 27017

テストデータの作成

テストデータを入力するには、以下のコマンドを実行します。

npx mongo-mcp create-users-collection

🛠️ Claude Desktopの設定

Claude DesktopがこのMCPサーバーを使用するように設定するには、smithery.toml ファイルを編集し、以下を追加します。

[mongo-mcp]
command = "node"
args = ["index.js"]

📁 テストサンドボックスのデータ構造

ユーザーコレクション

ユーザーコレクションには以下のフィールドが含まれます。

• _id: ドキュメントID
• username: ユーザー名
• email: メールアドレス
• password: パスワードハッシュ
• created_at: 作成タイムスタンプ
• updated_at: 更新タイムスタンプ

サンプルドキュメント:

{
  "_id": "63b4d207f8dfg5c1a7b1",
  "username": "exampleuser",
  "email": "user@example.com",
  "password": "$2y$10$92IXUNpkjO0rOQ5byMi.Ye4oKfW3p2.tU6VNU.0oGoeHabKN0u8F",
  "created_at": "2023-07-20T12:00:00Z",
  "updated_at": "2023-07-20T12:00:00Z"
}

製品コレクション

製品コレクションには以下のフィールドが含まれます。

• _id: ドキュメントID
• name: 製品名
• price: 価格（通貨単位）
• description: 説明
• category: カテゴリー
• stock: 在庫数
• created_at: 作成タイムスタンプ

サンプルドキュメント:

{
  "_id": "63b4d207f8dfg5c1a7b2",
  "name": "Example Product",
  "price": 9.99,
  "description": "This is an example product.",
  "category": "electronics",
  "stock": 10,
  "created_at": "2023-07-20T12:00:00Z"
}

注文コレクション

注文コレクションには以下のフィールドが含まれます。

• _id: ドキュメントID
• user_id: ユーザーID（ユーザーコレクションの _id を参照）
• products: 注文内の製品リスト（配列、製品IDと数量を含む）
• total_price: 合計価格（通貨単位）
• order_date: 注文日時タイムスタンプ
• status: 注文ステータス（例: "pending", "processing", "shipped", "delivered"）

サンプルドキュメント:

{
  "_id": "63b4d207f8dfg5c1a7b3",
  "user_id": "63b4d207f8dfg5c1a7b1",
  "products": [
    {
      "product_id": "63b4d207f8dfg5c1a7b2",
      "quantity": 2
    }
  ],
  "total_price": 19.98,
  "order_date": "2023-07-20T12:00:00Z",
  "status": "pending"
}

🛠️ 利用可能なツール

コマンドリスト

以下は、利用可能なコマンドとその機能です。

インデックス管理

• create-collection: 新しいMongoDBコレクションを作成します。
• drop-collection: 指定されたMongoDBコレクションを削除します。
• add-index: 指定されたコレクションにインデックスを追加します。
• remove-index: 指定されたコレクションからインデックスを削除します。

データ操作

• insert-doc: 単一のドキュメントを指定されたコレクションに挿入します。
• batch-insert: 複数のドキュメントを指定されたコレクションに一括挿入します。
• find-docs: 指定されたコレクション内のすべてのドキュメントをクエリします（条件付きでも可）。
• update-doc: 指定されたコレクション内の1つまたは複数のドキュメントを更新します。
• delete-doc: 指定されたコレクション内の1つまたは複数のドキュメントを削除します。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。

詳細については、プロジェクトの完全なドキュメントを参照してください。