Elasticsearch7 MCP Server

🚀 Elasticsearch 7.x MCP 服務器

為 Elasticsearch 7.x 提供 MCP 協議接口的服務器，支持與 Elasticsearch 7.x 版本兼容，可讓用戶通過 MCP 客戶端輕鬆訪問 Elasticsearch 功能。

🚀 快速開始

本服務器為 Elasticsearch 7.x 提供 MCP 協議接口，支持基本的 Elasticsearch 操作，如心跳檢測、信息查詢等，還完全支持搜索功能，包括聚合查詢、高亮顯示、排序和其他高級特性。

✨ 主要特性

• 提供 Elasticsearch 7.x 的 MCP 協議接口
• 支持基本的 Elasticsearch 操作（如心跳檢測、信息查詢等）
• 完全支持搜索功能，包括聚合查詢、高亮顯示、排序和其他高級特性
• 通過任何 MCP 客戶端輕鬆訪問 Elasticsearch 功能

📦 安裝指南

配置要求

• Python 3.10+ 或更高版本
• Elasticsearch 7.x（推薦使用 7.17.x 版本）

使用 Smithery 自動安裝

通過 Smithery 自動為 Claude 桌面安裝 Elasticsearch 7.x MCP Server：

npx -y @smithery/cli install @imlewc/elasticsearch7-mcp-server --client claude

手動安裝

pip install -e .

使用 Docker Compose

1. 創建 .env 文件並設置 ELASTIC_PASSWORD：

ELASTIC_PASSWORD=your_secure_password

2. 啟動服務：

docker-compose up -d

這將啟動一個三節點的 Elasticsearch 7.17.10 集群、Kibana 和 MCP 服務器。

💻 使用示例

環境變量配置

服務器需要以下環境變量：

• ELASTIC_HOST：Elasticsearch 服務地址（例如 http://localhost:9200）
• ELASTIC_USERNAME：Elasticsearch 用戶名
• ELASTIC_PASSWORD：Elasticsearch 密碼
• MCP_PORT：（可選）MCP 服務器監聽端口，默認為 9999

使用 MCP 客戶端

你可以使用任何 MCP 客戶端連接到 MCP 服務器：

from mcp import MCPClient

client = MCPClient("localhost:9999")
response = client.call("es-ping")
print(response)  # {"success": true}

搜索 API 示例

基本搜索

response = client.call("es-search", body={
    "query": {
        "match_all": {}
    }
})
print(response)

帶過濾的搜索

response = client.call("es-search", body={
    "query": {
        "term": {
            "field": "value"
        }
    }
}, index="your_index_name")
print(response)

📚 詳細文檔

環境變量說明

開發指南

1. 克隆倉庫：

git clone https://github.com/your-repository.git
cd your-repository

2. 安裝依賴項：

pip install -r requirements.txt

3. 啟動服務器：

python server.py

📄 許可證

有關許可證信息，請參閱 LICENSE 文件。