OpenSearch MCP 서버

개요

elastic-mcp-server 의 저장소 포크(Repository Fork)이며, opensearch-mcp-server MCP 서버로 변환되었습니다. 이는 OpenSearch 상호 작용을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 다양한 도구를 통해 문서 검색, 인덱스 분석 및 클러스터 관리를 지원합니다.

OpenSearch 상호작용을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버를 사용하면 다양한 도구를 통해 문서 검색, 인덱스 분석, 클러스터 관리가 가능합니다.

특징

인덱스 작업

list_indices : Opensearch 클러스터의 모든 인덱스를 나열합니다.
get_mapping : 특정 인덱스에 대한 매핑 구성을 검색합니다.
get_settings : 특정 인덱스에 대한 설정 구성을 가져옵니다.

문서 작업

search_documents : Opensearch Query DSL을 사용하여 인덱스에서 문서를 검색합니다.

클러스터 작업

get_cluster_health : 클러스터의 상태를 가져옵니다.
get_cluster_stats : 클러스터에 대한 통계 정보를 가져옵니다.

Opensearch 클러스터 시작

Docker Compose를 사용하여 Opensearch 클러스터를 시작합니다.

지엑스피1

이렇게 하면 3노드 Opensearch 클러스터와 Kibana가 시작됩니다. 기본 Opensearch 사용자 이름은 opensearch , 비밀번호는 test123 .

http://localhost:5601 에서 Kibana에 접속할 수 있습니다.

Claude Desktop과 함께 사용

로컬 개발에 UV 사용

uv 사용하려면 로컬 저장소를 복제하고 소스 코드 경로를 지정해야 합니다. Claude Desktop의 설정 파일 claude_desktop_config.json 에 다음 설정을 추가하세요.

path/to/src/opensearch_mcp_server 저장소를 복제한 경로로 변경해야 합니다.

{
  "mcpServers": {
    "opensearch": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/src/opensearch_mcp_server",
        "run",
        "opensearch-mcp-server"
      ],
      "env": {
        "OPENSEARCH_HOST": "https://localhost:9200",
        "OPENSEARCH_USERNAME": "opensearch",
        "OPENSEARCH_PASSWORD": "test123"
      }
    }
  }
}

macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

새로운 MCP 서버를 로드하려면 Claude Desktop을 다시 시작하세요.

이제 Claude를 통해 다음과 같은 자연어 명령을 사용하여 Opensearch 클러스터와 상호 작용할 수 있습니다.

"클러스터의 모든 인덱스를 나열합니다"
"학생 밥은 몇 살이에요?"
"클러스터 상태 보여주세요"

특허

이 프로젝트는 Apache 라이선스 버전 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.

OpenSearch MCP Server

Integrations