Elasticsearch MCP

🚀 Elasticsearch MCP 服務器

Elasticsearch MCP 服務器是一款用於管理 Elasticsearch 集群的工具，支持集群健康檢查、索引管理等多種操作。通過與 MCP 客戶端集成，用戶能以自然語言便捷交互，高效管理集群，提升工作效率。

🚀 快速開始

先決條件

• Elasticsearch 集群正常運行且可訪問。
• Node.js 環境已配置到位。
• npm 已安裝並可用。

安裝與設置

1. 使用 npm 包：

   npm install elastic-mcp-server
   

2. 配置 MCP 客戶端：

   • 打開你的編輯器，進入 MCP 設置界面。
   • 添加新的全局 MCP 服務器，指定以下配置：

     {
       "mcpServers": {
         "elasticsearch-mcp": {
           "command": "node",
           "args": [
             "/path/to/your/project/dist/index.js"
           ],
           "env": {
             "ES_HOST": "your-elasticsearch-host",
             "ES_API_KEY": "your-api-key"
           }
         }
       }
     }
     

✨ 主要特性

可用功能

• 集群管理：查看和監控 Elasticsearch 集群的整體狀態。
• 索引操作：創建、刪除和查詢索引信息。
• 映射配置：定義和修改索引字段類型。
• 數據操作：執行復雜查詢、聚合分析以及批量導入數據。
• 模板管理：管理和維護索引模板。

如何工作

MCP 客戶端通過發送請求到 MCP 服務器，後者解析並執行相應的 Elasticsearch 操作。用戶可以通過自然語言或命令行與 MCP 客戶端交互，完成對 Elasticsearch 集群的管理任務。

💻 使用示例

本地開發

基礎用法

# 使用正確的 Node.js 版本
nvm use
# 安裝依賴
npm install
# 啟動 MCP 服務器
node index.js

示例查詢

集群管理

• “我的 Elasticsearch 集群的健康狀態如何？”
• “集群中有多少個活躍節點？”

索引操作

• “我有哪些 Elasticsearch 索引？”
• “創建名為 'users' 的新索引，設置 3 個分片和 1 個副本。”
• “從 'old_index' 重新索引數據到 'new_index'。”

映射配置

• “查看 'users' 索引的映射信息。”
• “為 'age' 字段添加整數類型約束。”

數據操作

• “查找所有年齡大於 30 的用戶。”
• “統計過去一週用戶的登錄次數。”
• “批量導入一批新用戶數據。”

模板管理

• “列出所有當前的索引模板。”
• “應用指定的模板到新建索引。”

🔧 技術細節

配置選項

以下環境變量可配置 MCP 服務器的行為：

通過這些功能，Elasticsearch MCP 服務器為用戶提供了一種高效、便捷的方式來管理和操作 Elasticsearch 集群。無論是開發人員還是運維工程師，都可以從中受益，提升工作效率。