🚀 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 服务器”的错误，请执行以下步骤：
- 确认 Milvus 实例正在运行：
docker ps（如果是 Docker 部署） - 检查配置中的 URI 是否正确
- 确保没有防火墙阻止端口访问
- 使用
telnet localhost 19530测试 Milvus 端口是否可达
🔑 认证问题
如果出现认证错误，请检查：
- 环境变量
MILVUS_TOKEN是否正确设置 - 确认 Milvus 实例的用户管理配置是否允许当前用户访问
📄 更多资源
🤝 贡献指南
欢迎社区贡献！请访问我们的 GitHub 仓库 提交问题和拉取请求。