Typesense MCP 서버

Typesense와 인터페이스하는 Model Context Protocol (MCP) 서버입니다.

설치

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 Typesense 서버 통합을 자동으로 설치하려면 다음을 수행하세요:

npx -y @smithery/cli install @avarant/typesense-mcp-server --client claude

수동 설치

uv를 설치하세요.

Mac에서는 homebrew를 사용하여 설치할 수 있습니다.

brew install uv

패키지를 복제하세요.

git clone git@github.com:avarant/typesense-mcp-server.git ~/typesense-mcp-server

Cursor에서 사용하려면 .cursor/mcp.json을 업데이트하세요.

{
  "mcpServers": {
    "typesense": {
      "command": "uv",
      "args": ["--directory", "~/typesense-mcp-server", "run", "mcp", "run", "main.py"],
      "env": {
        "TYPESENSE_HOST": "",
        "TYPESENSE_PORT": "", 
        "TYPESENSE_PROTOCOL": "",
        "TYPESENSE_API_KEY": ""
      }
    }
  }
}

Related MCP server: Better Qdrant MCP Server

전송 방식

이 서버는 두 가지 MCP 전송 방식을 지원합니다. STDIO가 기본값이며 대부분의 데스크톱 클라이언트(Claude Desktop, Cursor 등)에서 사용됩니다. 원격 클라이언트, 웹 UI 또는 llama.cpp 채팅과 같은 상태 비저장 도구의 경우 HTTP SSE 리스너로 실행할 수 있습니다.

STDIO (기본값)

TYPESENSE_API_KEY=xyz uv run python main.py

HTTP / SSE

MCP_TRANSPORT=sse를 설정(또는 --sse 전달)하고 선택적으로 호스트/포트를 재정의하세요:

TYPESENSE_API_KEY=xyz \
MCP_TRANSPORT=sse \
MCP_HOST=0.0.0.0 \
MCP_PORT=8000 \
uv run python main.py

그러면 서버는 다음을 노출합니다:

• GET http://<host>:<port>/sse — SSE 이벤트 스트림 (클라이언트가 여기에 연결)

• POST http://<host>:<port>/messages/ — JSON-RPC 메시지 엔드포인트

사용 가능한 도구

Typesense MCP 서버는 다음 도구를 제공합니다:

서버 관리

• check_typesense_health - 구성된 Typesense 서버의 상태를 확인합니다.

• list_collections - Typesense 서버의 모든 컬렉션 목록을 가져옵니다.

컬렉션 관리

• describe_collection - 특정 컬렉션의 스키마와 메타데이터를 가져옵니다.

• export_collection - 특정 컬렉션의 모든 문서를 내보냅니다.

• create_collection - 제공된 스키마로 새 컬렉션을 생성합니다.

• delete_collection - 특정 컬렉션을 삭제합니다.

• truncate_collection - 스키마는 유지한 채 모든 문서를 삭제하여 컬렉션을 비웁니다.

문서 작업

• create_document - 특정 컬렉션에 단일 새 문서를 생성합니다.

• upsert_document - 특정 컬렉션의 단일 문서를 업서트(생성 또는 업데이트)합니다.

• index_multiple_documents - 여러 문서를 일괄적으로 인덱싱(생성, 업서트 또는 업데이트)합니다.

• delete_document - 특정 컬렉션에서 ID를 기준으로 단일 문서를 삭제합니다.

• import_documents_from_csv - CSV 데이터에서 컬렉션으로 문서를 가져옵니다.

검색 기능

• search - 특정 컬렉션에서 키워드 검색을 수행합니다.

• vector_search - 특정 컬렉션에서 벡터 유사도 검색을 수행합니다.