Mongo MCP Server

🚀 MongoDB MCP サーバー

このサーバーは、MongoDB データベース向けに設計されたモデルコンテキストプロトコル (MCP) サーバーです。MongoDB データベースの構造を分析し、人工知能を利用してクエリを生成することができます。

✨ 主な機能

1. ERD 生成（generateErd）

データベースのコレクション構造を分析し、エンティティ関係図 (ERD) を生成します。

• 入力パラメータ：

{
    "database": "string",
    "collections": ["string"],  // オプション
    "format": "mermaid" | "json"  // デフォルト値: "mermaid"
}

• 使用例：

{
    "database": "test",
    "format": "mermaid"
}

2. クエリ生成（generateQuery）

自然言語の説明に基づいて MongoDB クエリを生成します。データベースの実際の構造を分析することで、正確なクエリを提供します。

• 入力パラメータ：

{
    "database": "string",
    "collection": "string",
    "description": "string",
    "type": "mongodb" | "mongoose",  // デフォルト値: "mongodb"
    "includeExplanation": boolean  // デフォルト値: true
}

• 使用例：

{
    "database": "test",
    "collection": "users",
    "description": "今日新規登録されたユーザーを検索する",
    "type": "mongodb"
}

📦 インストール

1. 依存関係のインストール：

npm install

2. ビルド：

npm run build

3. サーバーの起動：

node dist/index.js "mongodb://localhost:27017"

📚 ドキュメント

Claude Desktop の設定

macOS で Claude Desktop と一緒に使用する場合は、以下の手順で設定してください。

1. 設定ファイルの場所：~/Library/Application Support/Claude/claude_desktop_config.json

2. MCP サーバーの設定を追加：

{
    "mcp": {
        "servers": [
            {
                "name": "mongodb",
                "command": "node /path/to/mongo-mcp-server/dist/index.js mongodb://localhost:27017/test"
            }
        ]
    }
}

3. Claude Desktop を再起動

開発

プロジェクト構造

src/
├── index.ts          # メインサーバーコード
├── tools/
│   ├── generateErd.ts    # ERD 生成ツール
│   └── generateQuery.ts  # クエリ生成ツール

新しいツールの追加

1. src/tools ディレクトリに新しいツールファイルを作成します。
2. ツールインターフェースを実装します。

export const newTool = {
    parameters: {
        // パラメータ定義
    },
    async execute(params: any, context: { client: MongoClient }) {
        // ツールのロジックを実装
    },
};

3. src/index.ts で新しいツールを登録します。