🚀 适用于Claude的兼容Milvus MCP服务器

此项目提供了将Anthropic的Claude（通过Claude Desktop）经由MCP（模型上下文协议）连接到Milvus向量数据库所需的全部内容。其价值在于搭建了Claude与Milvus之间的桥梁，让Claude能够借助Milvus强大的向量数据库功能，实现更高效的信息检索与处理。

📦 文件夹结构

.
├── 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

🚀 快速开始

克隆仓库

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的服务器
• 🗃️ Milvus设置（通过Docker）
• 🛠️ 启动服务器供Claude使用的Shell脚本
• ✅ 官方Milvus工具名称以确保与Claude兼容

🧠 工具命名规则（关键！）

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