Mongodb Database

🚀 MCP データベースサーバ

Model Context Protocol (MCP) サーバの実装で、大規模言語モデル (LLMs) が自然言語で複数のデータベースとやり取りできるようにします。現在は MongoDB をサポートしており、将来的には以下のデータベースのサポートを予定しています。

• PostgreSQL
• CockroachDB
• Redis
• など...

🚀 クイックスタート

MCP データベースサーバは、大規模言語モデルが自然言語でデータベースとやり取りするためのソリューションを提供します。現在は MongoDB をサポートしており、将来的には他のデータベースもサポート予定です。

✨ 主な機能

• 自然言語によるデータベース操作
• 現在の MongoDB サポート機能：
  • すべてのコレクションをリストする
  • フィルターと投影を伴うドキュメントクエリ
  • ドキュメントの挿入
  • ドキュメントの削除
  • 集約パイプライン操作
• 将来の他のデータベースサポート：
  • PostgreSQL：SQL クエリの実行、テーブル操作
  • CockroachDB：分散 SQL 操作
  • Redis：キー値操作、キャッシュ

📦 インストール

前提条件

• Node.js v20.12.2 またはそれ以上のバージョン
• データベース（現在は MongoDB、他のデータベースは近日追加予定）
• Claude Desktop アプリケーション

インストール手順

1. リポジトリをクローンします：

git clone https://github.com/manpreet2000/mcp-database-server.git
cd mcp-database-server

2. 依存関係をインストールします：

npm install

3. TypeScript コードをビルドします：

npm run build

📚 ドキュメント

設定

Claude Desktop で使用するには、設定ファイルにデータベース接続を設定する必要があります。

MacOS

~/Library/Application\ 支持/Claude/claude_desktop_config.json

Windows

%APPDATA%/Claude/claude_desktop_config.json

claude_desktop_config.json ファイルに以下の設定を追加します：

{
  "mcpServers": {
    "database": {
      "command": "/path/to/node",
      "args": ["/path/to/mcp-database/dist/index.js"],
      "env": {
        "MONGODB_URI": "your-mongodb-connection-string"
      }
    }
  }
}

以下を置き換えてください：

• /path/to/node：Node.js 実行ファイルのパス、または node
• /path/to/mcp-database：このリポジトリの絶対パス
• your-mongodb-connection-string：MongoDB の接続文字列

💻 使用例

基本的な使用法

MongoDB の例

1. データベース内のすべてのコレクションをリストする：

データベース内のすべてのコレクションを表示してくれますか？

2. 特定のコレクションからレコードを取得する：

chargers コレクションの 2 つのレコードを教えてください。

3. フィルター付きのクエリ：

users コレクションで状態が active のすべてのドキュメントを表示してください。

4. ドキュメントを挿入する：

{ "name": "Alice", "age": 30 } を users コレクションに挿入してください。

5. ドキュメントを削除する：

users コレクションから name が Bob のドキュメントを削除してください。

高度な使用法

利用可能なツール

• getCollections(): データベース内のすべてのコレクションを返します。
• getCollection(collectionName): 指定されたコレクションの参照を返します。
• find(query, projection): クエリ条件と投影に基づいて検索操作を実行します。
• insertOne(document): コレクションに単一のドキュメントを挿入します。
• insertMany(documents): コレクションに複数のドキュメントを挿入します。
• updateOne(query, update): クエリ条件を満たす最初のドキュメントを更新します。
• updateMany(query, update): クエリ条件を満たすすべてのドキュメントを更新します。
• replaceOne(query, replacement): クエリ条件を満たす最初のドキュメントを置き換えます。
• deleteOne(query): クエリ条件を満たす最初のドキュメントを削除します。
• deleteMany(query): クエリ条件を満たすすべてのドキュメントを削除します。

🔧 技術詳細

将来のデータベースサポート

• PostgreSQL：SQL クエリの実行、テーブル操作、スキーマ管理
• CockroachDB：分散トランザクション、SQL 操作の実行
• Redis：キー値ストレージ操作、リスト、セット、ハッシュテーブル、ソートセット操作