본문바로가기
Search MCP
AI Assistant OpenSearch Integration
Search MCP
AI Assistant OpenSearch Integration
Search MCP
Search MCP Server
AI 어시스턴트용 OpenSearch 연동 서버
  • Python 3.10+
  • FastMCP
  • OpenSearch
  • MCP Protocol
  • stdio / Streamable HTTP
  • Tools / Resources / Prompts
  • Project
    Search MCP Server
  • Release Date
    2026.03
  • Type
    MCP Server / Developer Tool
  • Role
    Backend Development
분류
MCP Server / Developer Tool
기술스택
Python 3.10+, FastMCP, OpenSearch, MCP Protocol, stdio, Streamable HTTP
GitHub
https://github.com/joodb
담당업무
MCP Server 설계/개발, Transport 구현, OpenSearch 연동, 테스트
주요기능
MCP Tools/Resources/Prompts, OpenSearch 검색 연동, Dual Transport (stdio + Streamable HTTP)
컨셉
AI Assistant OpenSearch Integration via MCP
특징
MCP Primitives (Tools, Resources, Prompts), Dual Transport, Context Window 관리
제작기간
약 2주
제작단가
5000만원 초과
Search MCP Server - MCP Architecture & Transport
MCP Architecture
& Transport

MCP(Model Context Protocol) 표준을 기반으로 AI 어시스턴트와 OpenSearch를 연결합니다.

Dual Transport 지원:
• stdio — Claude Desktop, Cursor 등 로컬 클라이언트와 표준 입출력 통신
• Streamable HTTP — 원격 클라이언트를 위한 HTTP 기반 스트리밍 전송

Search MCP Server - MCP Primitives
MCP Primitives
& FastMCP

FastMCP 프레임워크로 MCP 서버의 3가지 핵심 Primitive를 구현합니다.

• Tools — search_documents, get_index_info 등 AI가 호출하는 함수
• Resources — 클러스터 상태, 인덱스 매핑 등 컨텍스트 데이터 노출
• Prompts — 검색 쿼리 작성 가이드 등 재사용 가능한 프롬프트 템플릿

MCP Protocol Overview | MCP 프로토콜 개요

MCP(Model Context Protocol)는 Anthropic이 제안한 개방형 표준으로, AI 어시스턴트가 외부 시스템과 상호작용하기 위한 통신 규약입니다.

Host(Claude Desktop, Cursor 등)가 내장 MCP Client를 통해 MCP Server에 JSON-RPC 요청을 보내고, 서버는 OpenSearch 등 외부 서비스와 연동하여 결과를 반환합니다. 이 프로젝트는 이 구조를 FastMCP로 구현한 OpenSearch 전용 MCP Server입니다.

Transport Layer | 전송 계층

MCP는 두 가지 표준 Transport를 지원하며, 이 서버는 모두 구현합니다.

• stdio (Standard I/O) — 로컬 프로세스 간 표준 입출력 통신. Claude Desktop, Cursor 등이 MCP Server를 자식 프로세스로 실행하고 stdin/stdout으로 JSON-RPC 메시지를 교환합니다.

• Streamable HTTP — 원격 통신을 위한 HTTP 기반 전송. 단일 엔드포인트(/mcp)에서 POST로 요청을 받고, SSE(Server-Sent Events)로 스트리밍 응답을 반환합니다. 기존 SSE Transport를 대체하는 최신 MCP 표준입니다.

MCP Primitives & Tools | MCP 핵심 요소

FastMCP 프레임워크를 활용하여 MCP의 3가지 Server Primitive를 구현합니다.

• Tools — AI가 호출하는 함수. @mcp.tool() 데코레이터로 search_documents, get_index_info, get_cluster_health 등을 등록합니다. JSON Schema 기반 파라미터 검증이 자동 적용됩니다.

• Resources — AI에게 컨텍스트를 제공하는 읽기 전용 데이터. opensearch://cluster/status, opensearch://index/{name}/mapping 등 URI 템플릿으로 클러스터 상태와 인덱스 정보를 노출합니다.

• Prompts — 재사용 가능한 프롬프트 템플릿. 검색 쿼리 작성 가이드, 인덱스 분석 워크플로우 등을 사전 정의하여 AI의 OpenSearch 활용 품질을 높입니다.

Back to Main
거인소프트 대표작을 만나보세요.