Easysearch MCP Server

🚀 Easysearch MCP 服務器

這是一個 MCP 服務器，可讓 AI Agent 操作 INFINI Easysearch（兼容 Elasticsearch/OpenSearch API），為 AI 與搜索服務的交互提供便利。

🚀 快速開始

1. 配置 MCP 客戶端

Kiro (.kiro/settings/mcp.json)：

{
  "mcpServers": {
    "easysearch": {
      "command": "python3",
      "args": ["-m", "easysearch_mcp.server"],
      "cwd": "/path/to/easysearch-mcp-server/src",
      "env": {
        "EASYSEARCH_URL": "https://localhost:9200",
        "EASYSEARCH_USER": "admin",
        "EASYSEARCH_PASSWORD": "your-password",
        "PYTHONPATH": "/path/to/easysearch-mcp-server/src"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)：

{
  "mcpServers": {
    "easysearch": {
      "command": "python3",
      "args": ["-m", "easysearch_mcp.server"],
      "cwd": "/path/to/easysearch-mcp-server/src",
      "env": {
        "EASYSEARCH_URL": "https://localhost:9200",
        "EASYSEARCH_USER": "admin",
        "EASYSEARCH_PASSWORD": "your-password",
        "PYTHONPATH": "/path/to/easysearch-mcp-server/src"
      }
    }
  }
}

⚠️ 重要提示

將 /path/to/easysearch-mcp-server 替換為實際的項目路徑。

2. 開始使用

配置完成後，AI Agent 就可以直接操作 Easysearch 了，例如：

• "查看集群健康狀態"
• "創建一個 products 索引"
• "搜索價格大於 100 的商品"
• "統計每個分類的訂單數量"

✨ 主要特性

• 🔧 121 個工具：覆蓋集群、索引、文檔、搜索、監控等全部功能，滿足多樣化的操作需求。
• 🔌 即插即用：支持 Kiro、Claude Desktop 等 MCP 客戶端，方便集成。
• 🔒 安全連接：支持 HTTPS 和基礎認證，保障數據傳輸安全。
• ⚡ 高性能：基於 httpx 異步 HTTP 客戶端，提升操作效率。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/cloudsmithy/easysearch-mcp-server.git
cd easysearch-mcp-server

# 安裝依賴
pip install -e .

💻 使用示例

基礎用法

集群監控

查看集群健康狀態
→ cluster_health()

查看所有節點
→ cat_nodes()

查看線程池狀態
→ cat_thread_pool()

按大小排序查看索引
→ cat_indices(sort_by="store.size", order="desc")

索引操作

創建索引
→ index_create("products", 
    mappings={"properties": {"name": {"type": "text"}, "price": {"type": "float"}}},
    settings={"number_of_shards": 3})

寫入文檔
→ doc_index("products", {"name": "iPhone", "price": 999})

批量寫入
→ doc_bulk_simple("products", [
    {"name": "iPad", "price": 799},
    {"name": "MacBook", "price": 1299}
])

搜索查詢

簡單搜索
→ search_simple("products", "iPhone")

DSL 搜索
→ search("products", query={
    "bool": {
        "must": [{"match": {"name": "phone"}}],
        "filter": [{"range": {"price": {"lte": 1000}}}]
    }
})

聚合統計
→ aggregate("orders", aggs={
    "by_status": {"terms": {"field": "status"}},
    "avg_amount": {"avg": {"field": "amount"}}
})

SQL 查詢
→ sql_query("SELECT * FROM products WHERE price > 500 ORDER BY price DESC")

索引克隆/拆分/收縮

# 克隆索引（需要先設置只讀）
→ index_set_readonly("my-index", True)
→ index_clone("my-index", "my-index-clone")
→ index_set_readonly("my-index", False)

# 收縮索引（需要準備）
→ index_prepare_for_shrink("my-index")
→ index_shrink("my-index", "my-index-shrunk", {"index.number_of_shards": 1})

# 滾動索引（需要可寫別名）
→ index_create_with_write_alias("logs-000001", "logs")
→ index_rollover("logs", conditions={"max_docs": 1000000})

📚 詳細文檔

工具列表

集群管理 (8)

索引管理 (25)

別名管理 (4)

模板管理 (3)

文檔操作 (11)

搜索功能 (15)

CAT API (19)

節點管理 (5)

快照管理 (10)

快照生命週期管理 SLM (6)

任務管理 (3)

Ingest Pipeline (6)

ILM 索引生命週期管理 (5)

其他 (1)

環境變量

開發

# 克隆倉庫
git clone https://github.com/cloudsmithy/easysearch-mcp-server.git
cd easysearch-mcp-server

# 安裝依賴
pip install -e .

# 運行測試
pytest

# 代碼格式化
black src/
ruff check src/

兼容性測試

所有 121 個工具已在 INFINI Easysearch 上完成測試驗證：

⚠️ 重要提示

快照和 SLM 功能需要服務器配置 path.repo 才能創建倉庫。

📄 許可證

MIT License