Elasticsearch 7.x MCP Server
Elasticsearch 7.x MCP サーバー
Elasticsearch 7.x 用の MCP サーバー。Elasticsearch 7.x バージョンとの互換性を提供します。
特徴
Elasticsearch 7.x と対話するための MCP プロトコル インターフェースを提供します
基本的な Elasticsearch 操作 (ping、情報など) をサポートします
集計クエリ、ハイライト、並べ替え、その他の高度な機能を含む完全な検索機能をサポートします。
あらゆるMCPクライアントからElasticsearchの機能に簡単にアクセスできます
Related MCP server: Elasticsearch/OpenSearch MCP Server
要件
Python 3.10以上
Elasticsearch 7.x (7.17.x を推奨)
インストール
Smithery経由でインストール
Smithery経由で Claude Desktop 用の Elasticsearch 7.x MCP Server を自動的にインストールするには:
npx -y @smithery/cli install @imlewc/elasticsearch7-mcp-server --client claude手動インストール
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.-