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