mcp-meilisearch

MCP Meilisearch API 서버

StreamableHTTP 전송을 사용하여 AI 모델과 Meilisearch 검색 엔진을 연결하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 프로젝트는 Meilisearch의 강력한 검색 기능을 AI 워크플로우에 원활하게 통합할 수 있도록 지원합니다.

업데이트된 개요

이 프로젝트는 AI 모델이 Meilisearch 기능과 직접 상호 작용할 수 있도록 하는 MCP 서버를 제공합니다. 아키텍처는 다음과 같습니다.

• MCP 서버 : 모델 컨텍스트 프로토콜을 사용하여 Meilisearch API를 도구로 노출합니다.
• 웹 클라이언트 데모 : 검색 기능을 보여주는 데모 인터페이스입니다.

주요 특징

• StreamableHTTP 전송 : 클라이언트와 서버 간의 실시간 통신.
• Meilisearch API 지원 : Meilisearch 기능에 대한 전체 액세스.
• 향상된 오류 처리 : API 요청에 대한 오류 관리가 개선되었습니다.
• 웹 클라이언트 데모 : 검색 기능을 보여주기 위해 업데이트된 인터페이스입니다.

도구 카테고리

MCP 서버는 Meilisearch API를 다음 범주로 구성합니다.

1. 시스템 도구 : 상태 점검, 버전 정보, 서버 통계.
2. 인덱스 도구 : 인덱스를 관리합니다(생성, 업데이트, 삭제, 나열).
3. 문서 도구 : 문서를 추가, 업데이트, 삭제 및 검색합니다.
4. 검색 도구 : 벡터 검색을 포함한 고급 검색.
5. 설정 도구 : 인덱스 설정을 구성합니다.
6. 작업 도구 : 비동기 작업을 관리합니다.
7. 벡터 도구 : 실험적 벡터 검색 기능.

시작하기

필수 조건

• Node.js v20 이상.
• 실행 중인 Meilisearch 인스턴스(로컬 또는 원격).
• Meilisearch의 API 키(필요한 경우).

설치 지침

1. 저장소를 복제합니다.

지엑스피1

2. 종속성 설치:

3. 환경 구성:

다음 내용으로 .env 파일을 만듭니다.

서버 실행

서버를 시작하려면:

웹 인터페이스에 접근하기

브라우저에서 다음 URL을 방문하세요.

개발

이 프로젝트에서는 다음을 사용합니다.

• TypeScript : 타입 안전성을 보장합니다.
• Express : 웹 서버에 전원을 공급합니다.
• 모델 컨텍스트 프로토콜 SDK : AI 통합을 용이하게 합니다.

옵션

Meilisearch 연결 옵션

• meilisearchHost : Meilisearch 인스턴스의 URL(기본값: " http://localhost:7700 ")
• meilisearchApiKey : Meilisearch 인증을 위한 API 키(기본값: "")

MCP 서버 옵션

• transport : MCP 서버의 전송 유형("http" | "stdio")(기본값: "http")
• httpPort : MCP 서버의 HTTP 포트(기본값: 8080)
• mcpEndpoint : MCP 엔드포인트 경로(기본값: "/mcp")

세션 옵션

• sessionTimeout : 세션 시간 초과(밀리초) (기본값: 3600000)
• sessionCleanupInterval : 세션 정리 간격(밀리초) (기본값: 60000)

MCPClient 사용

이 패키지는 클라이언트 측 통합을 위해 MCPClient 클래스도 내보냅니다.