Manpreet2000 MCP Database Server

🚀 MCP データベースサーバ

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

• PostgreSQL
• CockroachDB
• Redis
• その他...

✨ 主な機能

• 自然言語でデータベース操作を実行できます。
• 現在の 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\ Support/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. ドキュメントを挿入します。

users コレクションに、名前が John でメールアドレスが john@example.com の新しいユーザーを追加してください。

5. ドキュメントを削除します。

users コレクションからメールアドレスが john@example.com のユーザーを削除してください。

6. アグリゲーション操作を実行します。

users コレクション内の状態別のユーザー総数を見せてください。

🛠️ 利用可能なツール

1. getCollections

データベース内のすべてのコレクションをリストします。

2. getCollection

指定された名前のコレクションを取得します。

パラメータ

• collectionName: 取得するコレクションの名前。

3. find

クエリ操作を実行し、指定された数の結果を返します。

パラメータ

• collectionName: クエリを実行するコレクションの名前。
• query（オプション）: クエリ条件。
• limit（オプション）: 返される結果の数を制限します。デフォルトは 5。

4. findOne

単一のドキュメントをクエリします。

パラメータ

• collectionName: クエリを実行するコレクションの名前。
• query: クエリ条件。

5. insertOne

新しいドキュメントを挿入します。

パラメータ

• collectionName: ドキュメントを挿入するコレクション。
• document: 挿入するドキュメントの内容。

6. deleteOne

指定されたクエリに一致する最初のドキュメントを削除します。

パラメータ

• collectionName: ドキュメントを削除するコレクション。
• query: 削除条件。

7. updateOne

指定されたクエリに一致する最初のドキュメントを更新し、新しい値を設定します。

パラメータ

• collectionName: ドキュメントを更新するコレクション。
• query: 更新条件。
• update: 新しい値。

🔮 将来的なサポート

将来的には以下のデータベースがサポートされます。

• PostgreSQL：自然言語で複雑な SQL クエリとテーブル操作を実行できます。
• CockroachDB：分散環境で効率的な SQL 操作を実行できます。
• Redis：キー値ペアのストレージとキャッシュ機能を利用して、高速なデータアクセスを実現します。

⚠️ セキュリティに関する注意事項

• 機密性：MongoDB 接続文字列が漏洩しないようにしてください。環境変数を使用して機密情報を管理することをおすすめします。
• 認証：本番環境では認証メカニズムを有効にし、データベースを不正アクセスから保護してください。

🤝 コントリビューションガイド

何か問題を発見したり、改善提案がある場合は、GitHub のイシューまたはプルリクエストを送信してください。あなたの貢献により、MCP データベースサーバの機能とパフォーマンスが向上します。