MongoDB MCP Server 🚀

MongoDB MCP サーバー 🚀

MongoDB との統合を実現する強力な Model Context Protocol（MCP）サーバー実装です。標準化されたプロトコルを通じて、MongoDB データベースとシームレスにやり取りできます。

🌟 作者

Syed Asad

📋 概要

この MCP サーバー実装は、Model Context Protocol を通じて MongoDB データベースとやり取りするための堅牢なインターフェースを提供します。適切な async/await パターンとエラー処理を用いて、データベース、コレクション、ドキュメントに対する操作をサポートします。

✨ 特長

• 🔄 MongoDB の CRUD 操作を全面的にサポート
• 🔐 MongoDB Atlas との安全な接続処理
• 🚦 最適なパフォーマンスを実現する async/await パターン
• 🛡️ 包括的なエラー処理
• 📦 簡単にデプロイできる Docker サポート
• 🔍 適切な型ヒントを用いたクエリ実行

🚀 クイックスタート

uvx を使用（Python）

# Run directly with uvx
uvx mongodb-mcp-bridge

# With SSE transport for remote connections
uvx mongodb-mcp-bridge --transport=sse

npx を使用（Node.js）

# Run directly with npx
npx mongodb-mcp-bridge

# With SSE transport for remote connections
npx mongodb-mcp-bridge --transport=sse

環境変数

サーバーを実行する前に、次の環境変数を設定します。

# Required
MONGODB_URI="your_mongodb_connection_string"

# Optional
MONGODB_DB="default_database_name"
MCP_PORT="6274"  # Default port for MCP Inspector

Docker を使用 🐳

# Build the Docker image
docker build -t mongodb-mcp-server .

# Run the container
docker run -e MONGODB_URI="your_mongodb_uri" -p 6274:6274 mongodb-mcp-server

🔗 IDE との統合

VS Code のセットアップ

以下を VS Code の settings.json に追加します。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "mongodbUri",
        "description": "MongoDB Connection URI"
      }
    ],
    "servers": {
      "mongodb": {
        "command": "uvx",
        "args": ["mongodb-mcp-bridge", "--transport=sse"],
        "env": {
          "MONGODB_URI": "$(mongodbUri)"
        }
      }
    }
  }
}

Cursor/Windsurf のセットアップ

Cursor または Windsurf で、次のように MCP サーバーを設定します。

{
  "mcp": {
    "servers": {
      "mongodb": {
        "url": "http://localhost:6274"
      }
    }
  }
}

📚 利用可能なツール

1. ping

   • MongoDB への接続を確認する簡単な接続テスト

2. list_databases

   • MongoDB インスタンスで利用可能なすべてのデータベースを一覧表示します

3. find_documents

   • フィルターオプションを指定して、コレクション内のドキュメントをクエリします
   • パラメーター：
     • database：データベース名
     • collection：コレクション名
     • query：MongoDB クエリオブジェクト（任意）
     • limit：返すドキュメントの最大数（デフォルト：10）

🔍 使用例

MCP Inspector（http://127.0.0.1:6274）を使用：

// List all databases
{
    "tool": "list_databases"
}

// Find documents in a collection
{
    "tool": "find_documents",
    "database": "your_database",
    "collection": "your_collection",
    "query": {"status": "active"},
    "limit": 5
}

🤝 コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. プルリクエストを作成します

📄 ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。

🙏 謝辞

• プロトコル仕様を提供してくれた Model Context Protocol（MCP）チーム
• 優れたデータベースとドライバーを提供してくれた MongoDB チーム
• このプロジェクトのすべてのコントリビューターとユーザー

---

Syed Asad が ❤️ を込めて作成