Skip to main content
Glama
suhail-ak-s

Typesense MCP Server

Typesense MCP 서버


npm 버전 라이센스: MIT Node.js 버전

AI 모델에 Typesense 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 통해 LLM은 Typesense 컬렉션에 저장된 데이터를 검색하고 분석할 수 있습니다.

데모

Typesense MCP 서버 데모 | Claude Desktop

Related MCP server: Typesense MCP Server

특징

자원

  • typesense:// URI를 통해 컬렉션을 나열하고 액세스합니다.

  • 각 컬렉션에는 이름, 설명 및 문서 수가 있습니다.

  • 스키마 액세스를 위한 JSON MIME 유형

도구

  • 타입센스_쿼리

    • 강력한 필터링을 통해 Typesense 컬렉션에서 문서를 검색하세요

    • 입력: 쿼리 텍스트, 컬렉션 이름, 검색 필드, 필터, 정렬 옵션, 제한

    • 관련성 점수와 일치하는 문서를 반환합니다.

  • 타입센스_겟_문서

    • 컬렉션에서 ID로 특정 문서 검색

    • 입력: 컬렉션 이름, 문서 ID

    • 전체 문서 데이터를 반환합니다.

  • 타입센스_컬렉션_통계

    • Typesense 컬렉션에 대한 통계 가져오기

    • 입력: 컬렉션 이름

    • 컬렉션 메타데이터, 문서 수 및 스키마 정보를 반환합니다.

프롬프트

  • 분석_수집

    • 컬렉션 구조 및 내용 분석

    • 입력: 컬렉션 이름

    • 출력: 스키마, 데이터 유형 및 통계에 대한 통찰력

  • 검색 제안

    • 컬렉션에 대한 효과적인 검색 쿼리에 대한 제안을 받으세요

    • 입력: 컬렉션 이름

    • 출력: 컬렉션 스키마를 기반으로 한 권장 검색 전략

설치

npm을 통해

지엑스피1

mcp-get을 통해

npx @michaellatman/mcp-get@latest install typesense-mcp-server

개발

종속성 설치:

npm install

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

개발을 위한 설치

Claude Desktop 사용

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "typesense": { "command": "node", "args": [ "~/typesense-mcp-server/dist/index.js", "--host", "your-typesense-host", "--port", "8108", "--protocol", "http", "--api-key", "your-api-key" ] }, } }

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

구성 요소

자원

서버는 Typesense 컬렉션에 대한 정보를 제공합니다.

  • 컬렉션 스키마 ( typesense://collections/<collection> )

    • 각 컬렉션에 대한 JSON 스키마 정보

    • 필드 이름과 데이터 유형이 포함됩니다.

    • 데이터 구조를 이해하기 위한 샘플 문서

리소스 템플릿

서버는 다음에 대한 템플릿을 제공합니다.

  • typesense_search - Typesense 검색 쿼리를 구성하기 위한 템플릿

  • typesense_collection - Typesense 컬렉션 세부 정보를 보기 위한 템플릿

Claude Desktop과 함께 사용

Claude Desktop 앱과 함께 이 서버를 사용하려면 claude_desktop_config.json 의 "mcpServers" 섹션에 다음 구성을 추가하세요.

{ "mcpServers": { "typesense": { "command": "npx", "args": [ "-y", "typesense-mcp-server", "--host", "your-typesense-host", "--port", "8108", "--protocol", "http", "--api-key", "your-api-key" ] } } }

벌채 반출

서버는 다음 위치에 있는 파일에 정보를 기록합니다.

/tmp/typesense-mcp.log

이 로그에는 서버 작업, 요청 및 발생하는 오류에 대한 자세한 정보가 포함되어 있습니다.

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

-
security - not tested
A
license - permissive license
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/suhail-ak-s/mcp-typesense-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server