Elasticsearch 7.x MCP Server
Elasticsearch 7.x MCP 服务器
Elasticsearch 7.x 的 MCP 服务器,提供与 Elasticsearch 7.x 版本的兼容性。
特征
提供与 Elasticsearch 7.x 交互的 MCP 协议接口
支持基本的 Elasticsearch 操作(ping、info 等)
支持完整的搜索功能,包括聚合查询、突出显示、排序和其他高级功能
通过任何 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 服务器:
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这将启动一个三节点 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.-