Milvus MCP Server

🚀 クレイド用互換Milvus MCPサーバー

このリポジトリは、MCP（モデルコンテキストプロトコル）を介して、AnthropicのClaude（Claude Desktop経由）をMilvusベクトルデータベースに接続するために必要なすべてのコンテンツを提供します。以下の要素が含まれています：

• 🧠 FastMCPと完全互換のサーバー
• 🗃️ Milvusの設定（Docker経由）
• 🛠️ Claudeでサーバーを起動するためのシェルスクリプト
• ✅ Claudeとの互換性を確保するための公式Milvusツール名

📦 フォルダ構造

.
├── milvus-standalone/                 # Milvus用のDocker Composeを含む
│   ├── docker-compose.yml
│   └── config/                        # Milvus etcd設定ファイル（必要な場合）
├── fastmcp/
│   ├── milvus-server/                # カスタムMCPサーバーファイル
│   │   ├── server.py                 # MCPサーバーコード
│   │   └── run_milvus_server.sh     # Claude用の起動スクリプト
│   ├── .venv/                        # uvで管理されるPython仮想環境
│   └── pyproject.toml                # FastMCP + 依存関係
├── claude_desktop_config.json        # このエントリをClaude設定に追加する
└── README.md

🚀 クイックスタート

📦 インストール

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

git clone https://github.com/YOUR_USERNAME/milvus-mcp-server
cd milvus-mcp-server

2. Milvus（Docker）を起動します。 Dockerがインストールされ、実行されていることを確認してください。

cd milvus-standalone
docker-compose up -d

3. uvをインストールします（まだインストールされていない場合）。

brew install uv

4. Python環境を同期します。 fastmcp/ディレクトリに移動します。

cd fastmcp
uv sync

💻 使用例

5. サーバーをテストします。

uv run python milvus-server/server.py

以下のようなログが表示されるはずです。

INFO: 连接到Milvus
✅ 服务器加载完成且工具已注册

6. Claudeの設定を更新します。 claude_desktop_config.jsonを以下のように更新します。

{
  "milvus": {
    "command": "/full/path/to/run_milvus_server.sh",
    "args": []
  }
}

更新後、Claudeを再起動してください。

7. Claudeを実行します。 以下のように試してみてください。

「Milvusツールを呼び出して、すべてのコレクションをリストします。」

これで接続し、実行されるはずです。

🧠 ツール命名規則（重要！）

Claudeは、Milvusの命名規則と完全に一致するツールのみを認識します。ツール名を変更しないでください。以下のような名前を使用します。

create_collection

list_collections

search

など。

コード内では、@mcp.tool(name="create_collection") のように名前を指定します。名前は大文字と小文字が区別されます。

🧪 デバッグテクニック

• Milvus Dockerが正常に動作していることを確認します（docker ps）。
• FastMCPサーバーのログを確認します。
• ツール内にprint文を追加してデバッグします。
• 一貫した.venvとuv環境を使用することを確認します。
• ツールの説明に絵文字や非ASCII文字を使用しないでください。

📌 今後の計画

• より多くのツールを追加します（delete_collection, upsertなど）。
• テストスクリプトを追加します（test_server.py）。
• GitHub Actionsを追加して検証を行います。

🧪 テスト

ツールのテストを手動で実行するには、test_server_full.pyまたはClaude Desktopインターフェイスを使用してください。

🤝 貢献者

• 開発：@TerrysPOV
• サポート：FastMCP
• ベクトルストレージ：Milvus
• 埋め込み：OpenAI（text-embedding-ada-002）

📄 ライセンス

MIT