Qdrant

🚀 MCP サーバー：mcp-server-qdrant 使用ガイド

このプロジェクトは MCP サーバーの使用方法を提供しています。以下の手順に従って、サーバーをセットアップし、使用することができます。

🚀 クイックスタート

まずは、MCP サーバーをセットアップして起動するための基本的な手順を紹介します。

📦 インストール

Node.js と npm のインストール

1. Node.js 公式サイトにアクセスし、お使いのオペレーティングシステムに適した Node.js バージョンをダウンロードしてインストールします。
2. npm（Node パッケージマネージャー）がインストールされていることを確認します。npm は Node.js の一部として提供されています。

MCP CLI のインストール

ターミナルまたはコマンドプロンプトで以下のコマンドを実行し、MCP CLI をグローバルにインストールします。

npm install mcp-cli -g

🔧 設定

ワークスペースの作成

1. ターミナルを開き、選択した作業ディレクトリに移動します。
2. 新しい Git リポジトリを初期化します（オプションですが、推奨します）。

git init

3. package.json ファイルを作成し、以下の内容を追加します。

{
  "name": "mcp-server-qdrant",
  "version": "1.0.0",
  "scripts": {
    "start": "mcp start mcp_server_qdrant/server.py"
  },
  "dependencies": {
    "mcp-cli": "^2.3.0"
  }
}

4. プロジェクトの依存関係をインストールします。

npm install

プロジェクトファイルの設定

1. .env ファイル

.env ファイルを作成し、以下の内容を追加します。

QDRANT_URL=http://localhost:6333
COLLECTION_NAME=mcp_demo

2. mcp_server_qdrant/server.py

新しい Python ファイル server.py を作成し、以下の内容を追加します。

import os
from mcp_server import server

if __name__ == "__main__":
    server.start(
        qdrant_url=os.getenv("QDRANT_URL"),
        collection_name=os.getenv("COLLECTION_NAME")
    )

💻 サービスの起動

npm スクリプトを使用して起動

ターミナルで以下のコマンドを実行します。

npm start

これにより、MCP サーバーが起動し、server.py で指定した QDrant URL とコレクション名が使用されます。

Python スクリプトを直接実行

npm スクリプトを使用しない場合は、以下のコマンドを直接実行できます。

python mcp_server_qdrant/server.py

🔧 MCP CLI の設定

MCP CLI は、MCP サーバーとやり取りするためのコマンドラインツールです。以下の方法でプロジェクトを設定できます。

グローバル設定

グローバルな mcp.json ファイル（$HOME/.config/mcp/cli/ にあります）を編集し、以下の内容を追加します。

{
  "global": {
    "servers": {
      "qdrant": {
        "command": "npm",
        "args": ["start"],
        "env": {}
      }
    }
  }
}

ワークスペース設定

プロジェクトのルートディレクトリに mcp.json ファイルを作成し、以下の内容を追加します。

{
  "servers": {
    "qdrant": {
      "command": "npm",
      "args": ["start"],
      "env": {}
    }
  }
}

💻 使用例

新しいプロジェクトの作成

ターミナルで以下のコマンドを実行し、新しいプロジェクトを作成します。

mcp new my_project
cd my_project

サーバーの起動

以下のコマンドを使用して、MCP サーバーを起動します。

mcp start

これにより、server.py で定義されたサーバーが起動します。

🤝 貢献

このプロジェクトへのコードの貢献を歓迎します！以下の方法で参加してください。

1. 問題の報告：GitHub で遭遇した問題を報告してください。
2. 機能リクエストの提出：同じく GitHub リポジトリで新しい機能リクエストを提出してください。
3. プルリクエスト：プロジェクトのバグ修正や新機能の追加を行うためのプルリクエストを送ってください。

🧪 テスト

MCP を使用したチェック

MCP CLI ツールを使用して、サーバーをチェックします。

mcp inspect

これにより、設定したサーバーの状態やその他の関連情報が表示されます。

手動テスト

ターミナルで以下のコマンドを実行し、サービスを手動で起動してテストします。

npm start

その後、http://localhost:6333 にアクセスすることで、接続している QDrant サービスの状態を確認できます。