Elasticsearch MCP Server

🚀 Elasticsearch/OpenSearch MCP 服務器

這是一個實現模型上下文協議（MCP）的服務器，具備與 Elasticsearch 和 OpenSearch 交互的能力。通過一系列實用工具，該服務器可支持搜索文檔、分析索引以及管理集群等操作。

🚀 快速開始

配置環境變量

# Elasticsearch 配置
ELASTICSEARCH_HOSTS=http://localhost:9200
ELASTICSEARCH_USERNAME=
ELASTICSEARCH_PASSWORD=

# OpenSearch 配置（如果需要）
OPENSEARCH_HOSTS=http://localhost:9200
OPENSEARCH_USERNAME=
OPENSEARCH_PASSWORD=

啟動 Elasticsearch/OpenSearch 集群

使用 Docker 啟動

# 啟動 Elasticsearch
docker run -d --name elasticsearch -p 9200:9200 -p 9300:9300 docker.elastic.co/elasticsearch/elasticsearch:7.17.2

# 啟動 OpenSearch
docker run -d --name opensearch -p 9200:9200 -p 9300:9300 amazon/opensearch:1.5.0

在 Claude Desktop 中使用

安裝方法

方法一：通過 uv 命令安裝

# Elasticsearch 版本
uv run mcp_client/client.py src/server.py --elasticsearch

# OpenSearch 版本
uv run mcp_client/client.py src/server.py --opensearch

✨ 主要特性

索引操作

• list_indices：列出集群中的所有索引。
• create_index：創建一個新的索引。
• delete_index：刪除指定的索引。
• update_mapping：更新索引的映射關係。

文檔操作

• search_docs：搜索指定索引中的文檔。
• get_doc：獲取指定索引和 ID 的文檔。
• index_doc：向指定索引添加或更新文檔。
• delete_doc：刪除指定索引和 ID 的文檔。

集群操作

• cluster_health：查看集群的健康狀態。
• cluster_stats：獲取集群的統計信息。
• nodes_info：列出集群中的所有節點及其信息。
• nodes_stats：獲取各個節點的詳細統計信息。

別名操作

• list_aliases：列出指定索引的所有別名。
• create_alias：創建一個新的別名。
• delete_alias：刪除指定的別名。
• update_alias：更新現有別名的配置。

📚 詳細文檔

演示

https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c9c

📄 許可證

此項目在 Apache License Version 2.0 下開源，具體信息請參閱 LICENSE 文件。