OpenSearch MCP Server

출처: 문서

본문

OpenSearch MCP Server

OpenSearch MCP Server는 오픈소스 Model Context Protocol (MCP) 서버예요. 이 서버는 OpenSearch를 Claude Desktop, Cursor, Kiro 등 MCP 호환 클라이언트에 노출해요. 연결되면 AI 어시스턴트가 원시 REST 요청을 생성하는 대신 MCP 도구를 사용하여 OpenSearch API를 호출함으로써 인덱스를 검색하고, 매핑을 읽고, 클러스터 상태를 확인하고, 다른 작업을 실행할 수 있어요.

OpenSearch는 또한 클러스터 내 MCP 커넥터를 제공해요. 이 커넥터는 OpenSearch 에이전트가 외부 MCP 서버에 호스팅된 도구를 호출할 수 있게 해줘요. 자세한 내용은 MCP 도구 사용을 참조하세요. {: .note}

OpenSearch MCP 서버는 다음과 같은 경우에 사용해요:

• AI 어시스턴트가 자연어로 OpenSearch 클러스터를 질의하고 탐색하게 해요.
• OpenSearch 클라이언트 계층을 구현하지 않고 내부 AI 도구(챗봇, 관찰 가능성 코파일럿, 데이터 어시스턴트)를 구축해요.
• 단일 어시스턴트 세션에서 여러 클러스터(예: dev, staging, production)에 연결해요.
• 표준 프로토콜을 사용하여 OpenSearch를 LangChain이나 LangGraph 같은 에이전트 프레임워크와 통합해요.

OpenSearch MCP 서버는 다음과 같은 기능을 제공해요:

• MCP 인터페이스: Claude Desktop, Cursor, Kiro 등 모든 MCP 호환 클라이언트를 지원해요.
• 도구: 인덱스 목록 조회, 매핑 검색, 검색 쿼리 실행, 클러스터 상태 확인, 문서 개수 세기 등의 도구를 포함해요. 필요에 따라 추가 도구 카테고리(검색 관련성 및 스킬 기반 분석)를 활성화할 수 있어요.
• 전송 옵션: 로컬 데스크톱 클라이언트의 경우 표준 입출력(stdio)을 지원하고, 원격 배포의 경우 스트리밍 전송(Server-Sent Events 및 HTTP 스트리밍)을 지원해요.
• 인증: 기본 인증, AWS IAM 역할, AWS 프로필 자격 증명, 헤더 기반 인증, 상호 TLS(mTLS), 익명 액세스를 지원해요.
• 클러스터 구성: 환경 변수를 사용한 단일 클러스터 모드 또는 YAML 구성 파일을 사용한 다중 클러스터 모드를 지원해요.
• 서비스 호환성: 자체 관리 OpenSearch, Amazon OpenSearch Service, Amazon OpenSearch Serverless 컬렉션과 함께 작동해요.

서버는 AI 클라이언트로부터 MCP 도구 호출을 받아 OpenSearch REST API 호출로 변환하고 구조화된 결과를 반환해요. 다음 다이어그램에서 이 과정을 보여줘요.

기본 제공 도구

핵심 도구는 기본적으로 활성화돼요. 환경 변수나 다중 클러스터 구성 파일을 사용하여 추가 도구 카테고리를 활성화할 수 있어요. 다음 표는 도구 카테고리를 보여줘요.

전체 목록과 도구별 매개변수는 opensearch-mcp-server-py README를 참조하세요.

다음 단계

• 서버를 설치하고 AI 클라이언트에 연결하려면 OpenSearch MCP 서버 사용을 참조하세요.

관련 문서

• opensearch-mcp-server-py -- GitHub의 소스 저장소예요.
• Model Context Protocol specification -- MCP 프로토콜 사양이에요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/ai-agent-integrations/mcp-server/index/