MCP Server For Milvus

🚀 MCP 服务器（Milvus 版）

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

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]}' 

高级用法

🌟 示例 1：列出集合

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

mcp-client list-collections

🌟 示例 2：创建索引

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

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 仓库 提交问题和拉取请求。