MCP Server For Milvus

🚀 MCP サーバー（Milvus 版）

MCP サーバー（Milvus 版）は、Milvus データベースと連携したサーバーで、データのクエリや挿入などの操作を効率的に行うことができます。

🚀 クイックスタート

インストール

以下のコマンドを使用して MCP サーバーをインストールします。

pip install mcp-server-milvus

設定

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

# MCP サーバーの基本設定
server:
  host: localhost   # MCP サーバーのホストアドレス、デフォルトは localhost
  port: 8000        # MCP サーバーのリッスンポート、デフォルトは 8000

# Milvus 接続設定
milvus:
  uri: ${MILVUS_URI}      # Milvus サービスの URI、環境変数 MILVUS_URI を使用可能
  token: ${MILVUS_TOKEN}   # Milvus 認証トークン、環境変数 MILVUS_TOKEN を使用可能
  db_name: ${MILVUS_DB}   # Milvus データベース名、デフォルトは default

サービスの起動

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

mcp-server start --config mcp_server_config.yaml

サービスの停止

実行中の MCP サーバーを停止するには、以下のコマンドを実行します。

mcp-server stop

✨ 主な機能

• データのクエリと挿入が可能です。
• Milvus データベースとの連携が容易です。
• 環境変数を使用した設定が可能です。

📦 インストール

使用するコマンドは以下の通りです。

pip install mcp-server-milvus

💻 使用例

基本的な使用法

データのクエリ

ターミナルで以下のコマンドを入力し、Milvus データベースからデータをクエリします。

mcp-client query --collection text_collection --filter "age > 20" --output_fields title,content

データの挿入

以下のコマンドを使用して指定されたコレクションにデータを挿入します。

mcp-client insert --collection user_profiles --data '{"name": ["Alice", "Bob"], "age": [30, 25]}' 

高度な使用法

コレクションの一覧表示

Milvus データベース内のすべてのコレクションを表示するには、以下のコマンドを使用します。

mcp-client list-collections

インデックスの作成

ターミナルで以下のコマンドを実行し、指定されたフィールドのインデックスを作成します。

mcp-client create-index --collection products --field price --index-type IVF_FLAT --params "{'nprobe': 10}"

📚 ドキュメント

環境変数

• MILVUS_URI：Milvus サービスの接続文字列（オプション、デフォルトは http://localhost:19530）
• MILVUS_TOKEN：認証用のトークン（オプション）
• MILVUS_DB：使用するデータベース名、デフォルトは "default"

開発

サーバーの実行

サーバーを直接実行するには、以下のコマンドを使用します。

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

デバッグとテスト

開発中は、以下のコマンドを使用してデバッグとテストを行うことができます。

uv run tests/test_server.py -v

🔧 技術詳細

接続問題

「Milvus サーバーに接続できません」というエラーが発生した場合は、以下の手順を実行してください。

1. Milvus インスタンスが実行中であることを確認します：docker ps（Docker でデプロイされている場合）
2. 設定内の URI が正しいことを確認します。
3. ファイアウォールがポートアクセスをブロックしていないことを確認します。
4. telnet localhost 19530 を使用して Milvus ポートが到達可能であることをテストします。

認証問題

認証エラーが発生した場合は、以下を確認してください。

1. 環境変数 MILVUS_TOKEN が正しく設定されていること。
2. Milvus インスタンスのユーザー管理設定が現在のユーザーのアクセスを許可していること。

📄 ライセンス

ライセンス情報は提供されていません。

参考リンク

• Milvus 公式ドキュメント
• Uvicorn サーバードキュメント
• Python-MongoDB ドライバードキュメント

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

コミュニティからのコントリビューションを歓迎します！問題やプルリクエストを提出するには、GitHub リポジトリ を訪問してください。