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

此仓库提供了所有必要的内容，用于通过MCP（模型上下文协议）将Anthropic的Claude（通过Claude Desktop）连接到Milvus向量数据库。它包括：

• 🧠 一个完全兼容FastMCP的服务器
• 🗃️ 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

🚀 设置指南

1. 克隆仓库

git clone https://github.com/YOUR_USERNAME/milvus-mcp-server
cd milvus-mcp-server

2. 运行Milvus（Docker） 确保已安装并运行了Docker。

cd milvus-standalone
docker-compose up -d

3. 安装uv（如果你还没有的话）

brew install uv

4. 同步Python环境 进入fastmcp/目录：

cd fastmcp
uv sync

5. 测试服务器

uv run python milvus-server/server.py

你应该会看到类似以下的日志：

INFO: 连接到Milvus
✅ 服务器加载完成且工具已注册

6. 更新Claude配置 更新claude_desktop_config.json如下：

{
  "milvus": {
    "command": "/full/path/to/run_milvus_server.sh",
    "args": []
  }
}

确保在更新后重新启动Claude。

7. 让Claude运行 尝试：

“调用Milvus工具列出所有集合。”

它现在应该连接并执行。

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

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