Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenElasticsearch MCP Server 是一个基于 Model Context Protocol (MCP) 标准的高性能服务器实现,专门为Elasticsearch数据源提供AI助手交互能力。本项目采用 Quarkus框架 构建,具有以下核心优势:
点击Release下载对应的启动包,如elasticsearch-mcp-server-runner.jar
[!CAUTION]
注意:以下示例启动方式默认连接本地http://localhost:9200,未设置密码连接,如需要改动地址或设置密码,请参考[🔧 启动参数](#-启动参数)指定参数或环境变量来启动应用
[!NOTE]
需要依赖本地环境安装JDK21+,但是该包不依赖任何架构,可以在任意架构运行
java -jar elasticsearch-mcp-server-runner.jar
#该启动方式默认连接本地http://localhost:9200,未设置密码连接,如需要改动地址或设置密码请参考🔧快速配置指定参数或环境变量
./elasticsearch-mcp-server-runner.exe
# 或者双击运行均可
chmod 755 elasticsearch-mcp-server-runner
./elasticsearch-mcp-server-runner
[!NOTE]
启动完成后,会自动启动sse和streamable两种通信方式, 并默认监听 0.0.0.0:19000
sse的endpoint为: /mcp/sse
streamable的endpoint为:/mcp
streamable: http://{ip}:19000/mcp
sse: http://{ip}:19000/mcp/sse
[!NOTE]
启动参数非必须的,比如需要连接远程elasticsearch,或者需要设置用户名密码,以下两种启动参数设置,二选一即可
#### 1. 命令行启动参数
elasticsearch.host=<your-es-server-address>
elasticsearch.username=<Your username>
elasticsearch.password=<Your password>
该命令行方式启动示例入下:
java -jar elasticsearch-mcp-server-runner.jar -Delasticsearch.host=http://localhost:9200 -Delasticsearch.username=<Your username> -Delasticsearch.password=<Your password>
# 临时生效以下环境变量,如果写入/etc/profile,也不用每次指定):
export ELASTICSEARCH_HOST=<your-es-server-address>
export ELASTICSEARCH_USERNAME=<your-es-useranme>
export ELASTICSEARCH_PASSWORD=<your_password>
该环境变量方式启动示例入下(需要再指定配置,会自动读取环境变量值
java -jar elasticsearch-mcp-server-runner.jar
本项目基于 Quarkus 构建,提供两种构建模式:
# 清理并打包
./mvnw clean package
或者
mvn clean package
# 生成的文件
# target/elasticsearch-mcp-server-runner.jar
# target/lib/ - 依赖库目录
# 原生镜像构建(需要安装GraalVM)
./mvnw package -Dnative
或者
mvn package -Dnative
# 生成的文件
# target/elasticsearch-mcp-server-runner
# 特点:启动更快,内存占用更低
# 上传jar包和lib目录到服务器
scp target/elasticsearch-mcp-server-runner.jar user@server:/opt/
scp -r target/lib user@server:/opt/
# 在服务器上运行
java -jar /opt/elasticsearch-mcp-server-runner.jar
# 上传原生可执行文件
scp target/elasticsearch-mcp-server-runner user@server:/opt/
# 在服务器上运行
./elasticsearch-mcp-server-runner
敬请期待,当前版本仅支持传统部署,后续肯定考虑支持,如有需要,可以在issue说出您的需求
elasticsearch-mcp-server/
├── src/main/java/org/gokeep/elasticsearch/mcp/server/
│ ├── basic/ # 基础抽象类
│ ├── config/ # 配置管理
│ ├── enmus/ # 枚举定义
│ ├── router/ # 路由定义
│ └── ElasticsearchMcpServer.java # 主服务类
├── src/main/resources/
│ └── application.properties # 配置文件
├── pom.xml # Maven配置文件
└── README.md # 项目文档
要添加新的Elasticsearch操作工具,只需在 ElasticsearchMcpServer.java 中添加新方法:
@Tool(description = "CN: 自定义Elasticsearch操作\nEN: Custom elasticsearch operation")
public ToolResponse customOperation(
@ToolArg(description = "参数描述") String param) throws Exception {
// 构建请求
HttpRequest request = buildRequest(Router.CUSTOM_ENDPOINT, param);
String response = call(request);
return ToolResponse.success(response);
}
然后在 router.Router 类中添加对应的路由常量。
@Tool(description = "CN: 执行Elasticsearch聚合查询\nEN: Execute elasticsearch aggregation")
public ToolResponse aggregate(
@ToolArg(description = "索引名") String indexName,
@ToolArg(description = "聚合查询语句") Map<String, Object> aggregation) throws Exception {
HttpRequest request = buildRequest(Router.AGGREGATE, aggregation, indexName);
String response = call(request);
return ToolResponse.success(response);
}
@Tool(description = "CN: 创建Elasticsearch索引\nEN: Create elasticsearch index")
public ToolResponse createIndex(
@ToolArg(description = "索引名") String indexName,
@ToolArg(description = "索引配置") Map<String, Object> settings) throws Exception {
HttpRequest request = buildRequest(Router.CREATE_INDEX, settings, indexName);
String response = call(request);
return ToolResponse.success(response);
}
# 服务器配置
quarkus.http.port=8080
# Elasticsearch配置
elasticsearch.host=http://localhost:9200
elasticsearch.username=
elasticsearch.password=
# 运行测试
./mvnw test
# 集成测试
./mvnw verify
# 开发模式(支持热部署)
./mvnw quarkus:dev
本项目采用 [MIT](MIT License) 许可证,支持任何商用和任何修改,无需版权声明
欢迎提交Issue和Pull Request来改进这个项目!
极易部署 • 高性能 • 低内存占用 • 云原生支持 •Java版本的Elasticsearch MCP服务
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Elasticsearch läuft lokal über stdio.
Zuletzt geprüft: 2026-10-27. 极易部署 • 高性能 • 低内存占用 • 云原生支持 •Java版本的Elasticsearch MCP服务