Milvus MCP Server

🚀 適用於Claude的兼容Milvus MCP服務器

此項目提供了將Anthropic的Claude（通過Claude Desktop）經由MCP（模型上下文協議）連接到Milvus向量數據庫所需的全部內容。其價值在於搭建了Claude與Milvus之間的橋樑，讓Claude能夠藉助Milvus強大的向量數據庫功能，實現更高效的信息檢索與處理。

📦 文件夾結構

.
├── milvus-standalone/                 # 包含Docker Compose用於Milvus
│   ├── 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

🚀 快速開始

克隆倉庫

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

運行Milvus（Docker）

確保已安裝並運行了Docker。

cd milvus-standalone
docker-compose up -d

安裝uv（如果你還沒有的話）

brew install uv

同步Python環境

進入fastmcp/目錄：

cd fastmcp
uv sync

測試服務器

uv run python milvus-server/server.py

你應該會看到類似以下的日誌：

INFO: 連接到Milvus
✅ 服務器加載完成且工具已註冊

更新Claude配置

更新claude_desktop_config.json如下：

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

確保在更新後重新啟動Claude。

讓Claude運行

嘗試：

“調用Milvus工具列出所有集合。”

它現在應該連接並執行。

✨ 主要特性

• 🧠 一個完全兼容FastMCP的服務器
• 🗃️ Milvus設置（通過Docker）
• 🛠️ 啟動服務器供Claude使用的Shell腳本
• ✅ 官方Milvus工具名稱以確保與Claude兼容

🧠 工具命名規則（關鍵！）

Claude僅識別與Milvus命名約定完全匹配的工具。不要重命名工具。使用：

create_collection

list_collections

search

等。

在代碼中使用@mcp.tool(name="create_collection")，名稱區分大小寫。

🧪 調試技巧

• 確保Milvus Docker運行健康（docker ps）
• 檢查FastMCP服務器日誌
• 在工具中添加打印語句以進行調試
• 確保使用一致的.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