Mcpmongo

🚀 MCP MongoDB 統合

このプロジェクトは、MongoDB とモデルコンテキストプロトコル（MCP）の統合を展示し、AI アシスタントにデータベースとの対話機能を提供します。プロジェクトは2つの主要なコンポーネントで構成されています。

1. MCP MongoDB サーバー - MongoDB 操作を MCP ツールとして提供するサーバー
2. クライアント Gemini 統合 - Google の Gemini AI を使用し、MongoDB ツールにアクセスするターミナルベースのチャットボット

🚀 クイックスタート

このセクションでは、MCP MongoDB 統合プロジェクトのセットアップと使用方法を説明します。

✨ 主な機能

• MongoDB 統合：完全な CRUD 操作を MCP ツールとして公開します。
• MCP サーバー：AI ツールで使用するためのモデルコンテキストプロトコルを実装します。
• Gemini AI 統合：Google の Gemini モデルに接続します。
• ターミナルチャットボット：データベース操作を行うための対話型チャットインターフェースを提供します。

📦 インストール

前提条件

• Node.js (v14 以上)
• MongoDB インスタンス（ローカルまたはリモート）
• Google Gemini API キー

サーバーのセットアップ

# サーバーディレクトリに移動
cd mcp-mongo-project

# 依存関係をインストール
npm install

# MongoDB 接続詳細を含む .env ファイルを作成
echo "MONGODB_URI=mongodb://localhost:27017" > .env
echo "MONGODB_NAME=your_database_name" >> .env

# サーバーを起動
npm start

クライアントのセットアップ

# クライアントディレクトリに移動
cd client-side

# 依存関係をインストール
npm install

# Gemini API キーを含む .env ファイルを作成
echo "GEMINI_API_KEY=your_gemini_api_key" > .env

# クライアントを起動
node index.js

💻 使用例

基本的な使用法

サーバーとクライアントが両方とも起動していると、チャットインターフェースを通じて MongoDB と対話できます。

あなた：データベース内のすべてのコレクションを表示
AI：データベース内で3つのコレクションを見つけました
[
  "users",
  "products",
  "orders"
]

あなた：年齢が30を超えるすべてのユーザーを検索
AI：コレクション 'users' 内で2つのドキュメントを見つけました
[
  {
    "_id": "6450a7c63020e15b2a1a",
    "name": "张三",
    "age": 35
  },
  {
    "_id": "6450a7d03020e15b2a1b",
    "name": "李四",
    "age": 32
  }
]

📚 ドキュメント

プロジェクト構造

.
├── client-side/            # クライアントアプリケーション（Gemini AI を使用）
│   ├── index.js            # クライアントのメインアプリケーション
│   └── package.json        # クライアントの依存関係
└── mcp-mongo-project/      # MongoDB ツールを持つ MCP サーバー
    ├── src/
    │   ├── index.js        # サーバー設定とツール定義
    │   └── services/
    │       └── mcp-service.js  # MongoDB サービスの実装
    └── package.json        # サーバーの依存関係

利用可能な MongoDB ツール

MCP サーバーは、以下の MongoDB 操作をツールとして公開しています。

• findDocuments：コレクション内のドキュメントをクエリします。
• findOneDocument：単一のドキュメントを検索します。
• insertOneDocument：1つのドキュメントを挿入します。
• insertManyDocuments：複数のドキュメントを挿入します。
• updateOneDocument：単一のドキュメントを更新します。
• updateManyDocuments：複数のドキュメントを更新します。
• deleteOneDocument：1つのドキュメントを削除します。
• deleteManyDocuments：複数のドキュメントを削除します。
• aggregateDocuments：集計パイプラインを実行します。
• countDocuments：コレクション内のドキュメント数を計算します。
• listCollections：すべてのコレクションをリストします。
• createCollection：新しいコレクションを作成します。

📄 ライセンス

[ここにライセンス情報を挿入]

貢献者

[貢献者をここにリスト]

リンク

[関連リンクをここに追加]