Elasticsearch 7.x MCP Server
Elasticsearch 7.x MCP 서버
Elasticsearch 7.x 버전과의 호환성을 제공하는 Elasticsearch 7.x용 MCP 서버입니다.
특징
Elasticsearch 7.x와 상호 작용하기 위한 MCP 프로토콜 인터페이스를 제공합니다.
기본적인 Elasticsearch 작업(ping, info 등)을 지원합니다.
집계 쿼리, 강조 표시, 정렬 및 기타 고급 기능을 포함한 완전한 검색 기능을 지원합니다.
모든 MCP 클라이언트를 통해 Elasticsearch 기능에 쉽게 액세스하세요
Related MCP server: Elasticsearch/OpenSearch MCP Server
요구 사항
파이썬 3.10+
Elasticsearch 7.x(7.17.x 권장)
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Elasticsearch 7.x MCP 서버를 자동으로 설치하려면:
지엑스피1
수동 설치
pip install -e .환경 변수
서버에는 다음과 같은 환경 변수가 필요합니다.
ELASTIC_HOST: Elasticsearch 호스트 주소(예: http://localhost:9200 )ELASTIC_USERNAME: Elasticsearch 사용자 이름ELASTIC_PASSWORD: Elasticsearch 비밀번호MCP_PORT: (선택 사항) MCP 서버 수신 포트, 기본값 9999
Docker Compose 사용
.env파일을 만들고ELASTIC_PASSWORD설정합니다.
ELASTIC_PASSWORD=your_secure_password서비스 시작:
docker-compose up -d이렇게 하면 3노드 Elasticsearch 7.17.10 클러스터, Kibana 및 MCP 서버가 시작됩니다.
MCP 클라이언트 사용
MCP 서버에 연결하려면 모든 MCP 클라이언트를 사용할 수 있습니다.
from mcp import MCPClient
client = MCPClient("localhost:9999")
response = client.call("es-ping")
print(response) # {"success": true}API 문서
현재 지원되는 MCP 방법:
es-ping: Elasticsearch 연결 확인es-info: Elasticsearch 클러스터 정보 가져오기es-search: Elasticsearch 인덱스에서 문서 검색
검색 API 예제
기본 검색
# Basic search
search_response = client.call("es-search", {
"index": "my_index",
"query": {
"match": {
"title": "search keywords"
}
},
"size": 10,
"from": 0
})집계 쿼리
# Aggregation query
agg_response = client.call("es-search", {
"index": "my_index",
"size": 0, # Only need aggregation results, no documents
"aggs": {
"categories": {
"terms": {
"field": "category.keyword",
"size": 10
}
},
"avg_price": {
"avg": {
"field": "price"
}
}
}
})고급 검색
# Advanced search with highlighting, sorting, and filtering
advanced_response = client.call("es-search", {
"index": "my_index",
"query": {
"bool": {
"must": [
{"match": {"content": "search term"}}
],
"filter": [
{"range": {"price": {"gte": 100, "lte": 200}}}
]
}
},
"sort": [
{"date": {"order": "desc"}},
"_score"
],
"highlight": {
"fields": {
"content": {}
}
},
"_source": ["title", "date", "price"]
})개발
저장소를 복제합니다
개발 종속성 설치
서버를 실행합니다:
elasticsearch7-mcp-server
특허
[LICENSE 파일의 라이센스]
Available Tools
3 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: es-info retrieves server information, es-ping checks connectivity, and es-search performs document searches. There is no overlap or ambiguity between these functions, making tool selection straightforward for an agent.
All tool names follow a consistent 'es-' prefix and underscore-separated verb pattern (es-info, es-ping, es-search). This predictable naming convention enhances readability and usability across the tool set.
With only 3 tools, the server feels thin for an Elasticsearch domain, which typically involves operations like indexing, updating, deleting, and aggregating documents. The count is too low to cover the expected scope of a database/search engine server.
The tool set is severely incomplete for Elasticsearch functionality. It lacks essential CRUD operations (e.g., create, update, delete documents), index management, and query features beyond basic search, which will likely cause agent failures in handling typical database tasks.
Maintenance
Related MCP Connectors
Agent-driven search: build, import, tune, search, and score result quality — all over MCP.
A paid remote MCP for Context7 MCP docs, built to return verdicts, receipts, usage logs, and audit-r
MCP server for searching Airweave collections with natural language queries.
Related MCP Servers
- AlicenseBqualityAmaintenanceFacilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.20317Apache 2.0
- AlicenseBqualityDmaintenanceAn MCP server that enables interaction with Elasticsearch and OpenSearch clusters for searching documents and managing indices. It provides tools for cluster health monitoring, index configuration, and general API requests.16Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables secure and efficient interaction with Elasticsearch clusters through the Model Context Protocol, providing tools for data management, search, and export.3,584 npm1MIT
- FlicenseNot gradedqualityDmaintenanceEnables read-only interaction with Elasticsearch, supporting listing indices, retrieving mappings, and executing search/aggregation queries via MCP.-