모델 컨텍스트 프로토콜(MCP)은 LLM 애플리케이션과 외부 데이터 소스 및 도구 간의 원활한 통합을 가능하게 하는 개방형 프로토콜입니다. AI 기반 IDE를 구축하든, 채팅 인터페이스를 개선하든, 맞춤형 AI 워크플로우를 만들든, MCP는 LLM과 필요한 맥락을 표준화하여 연결하는 방식을 제공합니다.

이 저장소에는 Milvus 벡터 데이터베이스 기능에 접근할 수 있는 MCP 서버가 포함되어 있습니다.

선수 조건

이 MCP 서버를 사용하기 전에 다음을 확인하세요:

• Python 3.10 이상
• 실행 중인 Milvus 인스턴스(로컬 또는 원격)
• UV 설치 (서버 실행에 권장됨)

사용

이 MCP 서버를 사용하는 권장 방법은 설치 없이 uv로 직접 실행하는 것입니다. 아래 예제에서 Claude Desktop과 Cursor 모두 이렇게 구성되어 있습니다.

저장소를 복제하고 싶다면:

그 후 서버를 직접 실행할 수 있습니다:

또는 src/mcp_server_milvus/ 디렉터리의 .env 파일을 변경하여 환경 변수를 설정하고 다음 명령어로 서버를 실행할 수도 있습니다:

중요: .env 파일이 명령줄 인수보다 우선순위가 더 높습니다.

달리기 모드

MCP Server for Milvus

The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you’re building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need.

This repository contains a MCP server that provides access to Milvus vector database functionality.

Prerequisites

Before using this MCP server, ensure you have:

• Python 3.10 or higher
• A running Milvus instance (local or remote)
• uv installed (recommended for running the server)

Usage

The recommended way to use this MCP server is to run it directly with uv without installation. This is how both Claude Desktop and Cursor are configured to use it in the examples below.

If you want to clone the repository:

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

Then you can run the server directly:

uv run src/mcp_server_milvus/server.py --milvus-uri http://localhost:19530

Alternatively you can change the .env file in the src/mcp_server_milvus/ directory to set the environment variables and run the server with the following command:

uv run src/mcp_server_milvus/server.py

Important: the .env file will have higher priority than the command line arguments.

Running Modes

The server supports two running modes: stdio (default) and SSE (Server-Sent Events).

Stdio Mode (Default)

• Description: Communicates with the client via standard input/output. This is the default mode if no mode is specified.

• Usage:

  uv run src/mcp_server_milvus/server.py --milvus-uri http://localhost:19530
  

SSE Mode

• Description: Uses HTTP Server-Sent Events for communication. This mode allows multiple clients to connect via HTTP and is suitable for web-based applications.

• Usage:

  uv run src/mcp_server_milvus/server.py --sse --milvus-uri http://localhost:19530 --port 8000
  

  • --sse: Enables SSE mode.
  • --port: Specifies the port for the SSE server (default: 8000).

• Debugging in SSE Mode:

  If you want to debug in SSE mode, after starting the SSE service, enter the following command:

  mcp dev src/mcp_server_milvus/server.py
  

  The output will be similar to:

  % mcp dev src/mcp_server_milvus/merged_server.py
  Starting MCP inspector...
  ⚙️ Proxy server listening on port 6277
  🔍 MCP Inspector is up and running at http://127.0.0.1:6274 🚀
  

  You can then access the MCP Inspector at http://127.0.0.1:6274 for testing.

Streamable HTTP Mode