Mongodb Model Context Protocol MCP

🚀 MongoDB モデルコンテキストプロトコル (MCP) サーバー for LLM

このサーバーは、Model Context Protocol (MCP) を用いて、LLMが直接MongoDBデータベースとやり取りできるようにします。自然言語で集合のクエリを実行し、スキーマをチェックし、データを管理および処理することが可能です。

✨ 主な機能

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

🎥 デモビデオ

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

🚀 クイックスタート

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

MacOS: ~/Library/Application\ 支持/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. テストデータを作成するためにseedスクリプトを実行します。

npm run seed

Claude Desktopの設定

異なるオペレーティングシステムで設定ファイルを編集します。

MacOS および Linux:
~/.config/Claude/claude_config.json ファイルを編集し、以下の内容を追加します。

"mongo-mcp": {
  " connectionString": "mongodb://localhost:27017"
}

Windows:
%APPDATA%/Claude/claude_config.json ファイルを編集し、同様の内容を追加します。

💻 使用例

基本的な使用法

# すべてのドキュメントをクエリする
/mongo-mcp --query '{"command": "findAll"}'

# 新しいドキュメントを挿入する
/mongo-mcp --insert '{"name": "test", "value": 123}'

高度な使用法

# 条件による検索
/mongo-mcp --search '{"name": "test"}' --projection '{"_id": 0, "name": 1}'

# ドキュメントの更新
/mongo-mcp --update '{"query": {"name": "test"}, "update": {"$set": {"value": 456}}}'

インデックス管理

# インデックスの作成
/mongo-mcp --create-index '{"collection": "users", "index": { "field": 1 }}'

# インデックスの削除
/mongo-mcp --drop-index '{"collection": "users", "indexName": "field_1"}'

🛠️ 利用可能なツール

クエリツール

• find: すべてのドキュメントを検索
• search: 条件に基づいて検索
• insert: 新しいドキュメントを挿入
• update: 既存のドキュメントを更新
• delete: ドキュメントを削除

インデックスツール

• create-index: インデックスを作成
• drop-index: インデックスを削除
• indexes: 集合のインデックスを一覧表示

📄 ライセンス

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