🚀 适用于Claude的兼容Milvus MCP服务器
此仓库提供了通过MCP（模型上下文协议）将Anthropic的Claude（通过Claude Desktop）连接到Milvus向量数据库所需的全部内容。它能帮助你轻松实现Claude与Milvus的对接，主要价值在于：
- 提供完全兼容FastMCP的服务器，确保高效稳定的连接。
- 包含Milvus的Docker设置，简化部署流程。
- 提供启动服务器的Shell脚本，方便Claude使用。
- 使用官方Milvus工具名称，保证与Claude的兼容性。
🚀 快速开始
克隆仓库
git clone https://github.com/YOUR_USERNAME/milvus-mcp-server
cd milvus-mcp-server
运行Milvus（Docker）
确保已安装并运行了Docker。
cd milvus-standalone
docker-compose up -d
安装uv（如果你还没有的话）
brew install uv
同步Python环境
进入fastmcp/目录：
cd fastmcp
uv sync
测试服务器
uv run python milvus-server/server.py
你应该会看到类似以下的日志：
INFO: 连接到Milvus
✅ 服务器加载完成且工具已注册
更新Claude配置
更新claude_desktop_config.json如下：
{
"milvus": {
"command": "/full/path/to/run_milvus_server.sh",
"args": []
}
}
确保在更新后重新启动Claude。
让Claude运行
尝试：
“调用Milvus工具列出所有集合。”
它现在应该连接并执行。
✨ 主要特性
- 🧠 一个完全兼容FastMCP的服务器，保障与Claude的高效交互。
- 🗃️ Milvus设置（通过Docker），简化部署流程。
- 🛠️ 启动服务器供Claude使用的Shell脚本，方便快捷。
- ✅ 官方Milvus工具名称以确保与Claude兼容。
📦 安装指南
按照上述快速开始的步骤操作，即可完成安装和配置。
📦 文件夹结构
.
├── milvus-standalone/ # 包含Docker Compose用于Milvus
│ ├── docker-compose.yml
│ └── config/ # Milvus etcd配置文件（如需）
├── fastmcp/
│ ├── milvus-server/ # 你的自定义MCP服务器文件
│ │ ├── server.py # MCP服务器代码
│ │ └── run_milvus_server.sh # 用于Claude的启动脚本
│ ├── .venv/ # uv管理的Python虚拟环境
│ └── pyproject.toml # FastMCP + 依赖项
├── claude_desktop_config.json # 添加此条目到Claude配置中
└── README.md
🧠 工具命名规则（关键！）
Claude仅识别与Milvus命名约定完全匹配的工具。不要重命名工具。使用：
create_collection
list_collections
search
等。
在代码中使用@mcp.tool(name="create_collection")，名称区分大小写。
🧪 调试技巧
- 确保Milvus Docker运行健康（docker ps）
- 检查FastMCP服务器日志
- 在工具中添加打印语句以进行调试
- 确保使用一致的.venv和uv环境
- 不要在工具描述中使用表情符号或非ASCII字符
📌 下一步计划
- 添加更多工具（delete_collection, upsert等）
- 添加测试脚本（test_server.py）
- 为验证添加GitHub Actions
🧪 测试
要手动运行工具测试，请使用test_server_full.py或Claude Desktop界面。
🤝 贡献者
- 开发：@TerrysPOV
- 支持：FastMCP
- 向量存储在Milvus中
- 嵌入式通过OpenAI（text-embedding-ada-002）
📄 许可证
MIT