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

MCP 服务器功能概述

功能列表

数据操作工具

• 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 服务器以获取实时支持