MCP Server Milvus

🚀 MCP 服務器安裝指南

本指南將幫助你完成 MCP 服務器的安裝與配置，同時介紹其功能及使用方法。

🚀 快速開始

📦 安裝指南

基本命令

使用以下命令安裝 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 服務器以獲取即時支持