MCP 服务器（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 数据库查询数据：

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_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

示例

示例 1：列出集合

要查看 Milvus 数据库中的所有集合，可以使用以下命令：

mcp-client list-collections

示例 2：创建索引

在终端中执行以下命令以创建指定字段的索引：

mcp-client create-index --collection products --field price --index-type IVF_FLAT --params "{'nprobe': 10}"

故障排除

常见问题

连接问题

如果出现“无法连接到 Milvus 服务器”的错误，请执行以下步骤：

1. 确认 Milvus 实例正在运行：docker ps（如果是 Docker 部署）
2. 检查配置中的 URI 是否正确
3. 确保没有防火墙阻止端口访问
4. 使用 telnet localhost 19530 测试 Milvus 端口是否可达

认证问题

如果出现认证错误，请检查：

1. 环境变量 MILVUS_TOKEN 是否正确设置
2. 确认 Milvus 实例的用户管理配置是否允许当前用户访问

更多资源

• Milvus 官方文档
• Uvicorn 服务器文档
• Python-MongoDB 驱动文档

贡献指南

欢迎社区贡献！请访问我们的 GitHub 仓库 提交问题和拉取请求。