MCP Server For Milvus

🚀 MCP 服務器（Milvus 版）

MCP 服務器（Milvus 版）是一個與 Milvus 數據庫集成的服務器，可幫助用戶方便地對 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 數據庫進行數據查詢、插入等操作。
• 支持通過環境變量配置 Milvus 服務連接信息，增強了配置的靈活性。

📦 安裝指南

安裝 MCP 服務器

使用 pip 命令進行安裝：

pip install mcp-server-milvus

配置文件設置

創建並編輯 mcp_server_config.yaml 文件，根據需求配置 MCP 服務器和 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 倉庫 提交問題和拉取請求。