MCP Server for Milvus - Quick Start Guide

Model Context Protocol (MCP) 是一种开放协议，使 LLM 应用能与外部数据源和工具无缝集成。此仓库提供了一个 MCP 服务器，用于访问 Milvus 向量数据库功能。

先决条件

• Python 3.10+
• 运行中的 Milvus 实例
• 已安装 uv（推荐）

基本使用

# 克隆仓库
git clone https://github.com/stephen37/mcp-server-milvus.git
cd mcp-server-milvus

# 运行服务器
uv run src/mcp_server_milvus/server.py --milvus-uri http://localhost:19530

与支持的应用集成

Claude Desktop 集成

1. 安装 Claude Desktop 并打开配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 添加以下配置：

{
  "mcpServers": {
    "milvus": {
      "command": "/PATH/TO/uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-milvus/src/mcp_server_milvus",
        "run",
        "server.py",
        "--milvus-uri",
        "http://localhost:19530"
      ]
    }
  }
}

3. 重启 Claude Desktop

Cursor 集成

选项 1：通过设置 UI

1. 转到 Settings > Features > MCP
2. 点击 + Add New MCP Server
3. 配置表单：
   • 类型: stdio
   • 名称: milvus
   • 命令: /PATH/TO/uv --directory /path/to/mcp-server-milvus/src/mcp_server_milvus run server.py --milvus-uri http://127.0.0.1:19530

选项 2：项目特定配置（推荐）

1. 创建配置目录和文件：

mkdir -p /path/to/your/project/.cursor

2. 创建 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "milvus": {
      "command": "/PATH/TO/uv",
      "args": [
        "--directory",
        "/path/to/mcp-server-milvus/src/mcp_server_milvus",
        "run",
        "server.py",
        "--milvus-uri",
        "http://127.0.0.1:19530"
      ]
    }
  }
}

3. 重启 Cursor 或重新加载窗口

主要功能

服务器提供以下核心工具：

搜索工具

• milvus-text-search - 全文搜索
• milvus-vector-search - 向量相似度搜索
• milvus-hybrid-search - 结合向量相似度和属性过滤的搜索
• milvus-query - 使用过滤表达式查询集合

集合管理

• milvus-list-collections - 列出所有集合
• milvus-collection-info - 获取集合详情
• milvus-create-collection - 创建新集合
• milvus-load-collection - 将集合加载到内存中
• milvus-release-collection - 从内存中释放集合

集成完成后，支持的应用程序将自动使用这些工具进行相关查询。