MCP Server Milvus

🚀 MCP サーバー

MCP サーバーは、Milvus と連携してデータ操作や管理を行うためのツールです。このサーバーを使用することで、Milvus の各種機能を簡単に利用できます。

🚀 クイックスタート

MCP サーバーを使用するには、まずインストールと環境設定が必要です。以下の手順に従ってセットアップしてください。

📦 インストール

基本コマンド

pip install mcp-server-milvus

オプションの構成パラメータ

• --milvus-uri：Milvus サービスの URI を指定します（デフォルト値は http://localhost:19530）
• --api-key：API キーを指定します（認証が必要な場合）

環境変数の構成

export MILVUS_URI="http://localhost:19530"

オプションの構成パラメータ

• MILVUS_URI：Milvus サービスの URI
• MILVUS_TOKEN：オプションの認証トークン
• MILVUS_DB：データベース名（デフォルトは "default"）

サーバーの直接実行

uv run server.py --milvus-uri http://localhost:19530

✨ 主な機能

データ操作ツール

• milvus-list-collections：すべてのコレクションをリストします
• milvus-get-collection-info：指定されたコレクションの情報を取得します
• milvus-text-search：テキスト検索を実行します
• milvus-vector-search：ベクトル検索を実行します
• milvus-insert：データを挿入します
• milvus-query：データをクエリします
• milvus-delete-by-id：ID でデータを削除します
• milvus-update：データを更新します

コレクション管理ツール

• milvus-create-collection：新しいコレクションを作成します
• milvus-drop-collection：指定されたコレクションを削除します
• milvus-add-field：既存のコレクションにフィールドを追加します
• milvus-get-schema：コレクションのスキーマ情報を取得します

インデックス管理ツール

• milvus-create-index：指定されたフィールドにインデックスを作成します
• milvus-get-index-info：指定されたフィールドのインデックス情報を取得します
• milvus-drop-index：指定されたフィールドのインデックスを削除します

💻 使用例

基本的な使用法

例 1：すべてのコレクションをリストする

What are the collections I have in my Milvus DB?

Claude は MCP を使用してこの情報を確認します：

I'll check what collections are available in your Milvus database.

> View result from milvus-list-collections from milvus (local)

Here are the collections in your Milvus database:

1. rag_demo
2. test
3. chat_messages
4. text_collection
5. image_collection
6. document_store

例 2：テキスト検索を実行する

How can I search for specific documents using text?

Claude の返答：

You can use the milvus-text-search command to perform text searches on a collection.

For example:
```bash
milvus-text-search --collection-name your_collection_name --query "your_search_query"

例 3：ベクトル検索を実行する

How can I search for similar items using vectors?

Claude の返答：

You can use the milvus-vector-search command to perform vector searches on a collection.

For example:
```bash
milvus-vector-search --collection-name your_collection_name --vector-id 12345

🔧 トラブルシューティング

一般的な問題

• Milvus への接続ができない：Milvus サービスが http://localhost:19530 で実行されていることを確認し、ネットワークに問題がないことを確認してください。
• 認証に失敗する：API キーまたはトークンが正しく構成されていることを確認してください。

📚 ドキュメント

サポートチャネル

• GitHub Issues：https://github.com/your-repository/issues
• Discord コミュニティ：リアルタイムサポートを受けるために、Discord サーバーに参加してください