Mongodb MCP

🚀 🗄️ MongoDB MCP サーバー for LLM

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

🚀 クイックスタート

始めるには、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を通じてClaude Desktop用のMongoDB MCPサーバーを自動インストールするには、以下のコマンドを実行します。

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

必要条件

• Node.js 18+
• npx
• DockerとDocker Compose（ローカルサンドボックステストのみ）
• MCPクライアント（例：Claude Desktop App）

テストサンドボックスの設定

利用可能なMongoDBサーバーがなく、サンプルサンドボックスを作成したい場合は、以下の手順に従います。

1. Docker Composeを使用してMongoDBを起動します。

docker-compose up -d

2. テストデータをデータベースに投入します。

npm run seed

Claude Desktopの設定

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

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

ローカル開発モード:

{
  "mcpServers": {
    "mongodb": {
      "command": "node",
      "args": [
        "dist/index.js",
        "mongodb://root:example@localhost:27017/test?authSource=admin"
      ]
    }
  }
}

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

シードスクリプトは、サンプルデータを持つ3つのコレクションを作成します。

ユーザー

• 個人情報（名前、メールアドレス、年齢）
• ネストされた住所とその座標
• 興味の配列
• 会員登録日

コンテンツ

• ドキュメントのタイトル
• ドキュメントの内容
• 作成日
• 更新日

注文

• 顧客ID
• 注文詳細
• 注文状態
• 注文日

✨ 主な機能

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

デモビデオ

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

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。