Easysearch MCP Server

🚀 Easysearch MCP Server

An MCP server that enables AI agents to operate INFINI Easysearch, which is compatible with Elasticsearch/OpenSearch APIs.

✨ Features

• 🔧 121 Tools: Covering all functions such as cluster, index, document, search, and monitoring.
• 🔌 Plug-and-Play: Supporting MCP clients like Kiro and Claude Desktop.
• 🔒 Secure Connection: Supporting HTTPS and basic authentication.
• ⚡ High Performance: Based on the httpx asynchronous HTTP client.

📦 Installation

# Clone the repository
git clone https://github.com/cloudsmithy/easysearch-mcp-server.git
cd easysearch-mcp-server

# Install dependencies
pip install -e .

🚀 Quick Start

1. Configure the MCP Client

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"
      }
    }
  }
}

⚠️ Important Note

Replace /path/to/easysearch-mcp-server with the actual project path.

2. Start Using

After configuration, the AI agent can directly operate Easysearch:

• "Check the cluster health status"
• "Create a products index"
• "Search for products with a price greater than 100"
• "Count the number of orders in each category"

Tool List

Cluster Management (8)

Index Management (25)

Alias Management (4)

Template Management (3)

Document Operations (11)

Search Functions (15)

CAT API (19)

Node Management (5)

Snapshot Management (10)

Snapshot Lifecycle Management SLM (6)

Task Management (3)

Ingest Pipeline (6)

ILM Index Lifecycle Management (5)

Others (1)

💻 Usage Examples

Cluster Monitoring

Check the cluster health status
→ cluster_health()

View all nodes
→ cat_nodes()

View the thread pool status
→ cat_thread_pool()

View indices sorted by size
→ cat_indices(sort_by="store.size", order="desc")

Index Operations

Create an index
→ index_create("products", 
    mappings={"properties": {"name": {"type": "text"}, "price": {"type": "float"}}},
    settings={"number_of_shards": 3})

Write a document
→ doc_index("products", {"name": "iPhone", "price": 999})

Batch writing
→ doc_bulk_simple("products", [
    {"name": "iPad", "price": 799},
    {"name": "MacBook", "price": 1299}
])

Search Queries

Simple search
→ search_simple("products", "iPhone")

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

Aggregation statistics
→ aggregate("orders", aggs={
    "by_status": {"terms": {"field": "status"}},
    "avg_amount": {"avg": {"field": "amount"}}
})

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

Index Cloning/Splitting/Shrinking

# Clone an index (need to set read-only first)
→ index_set_readonly("my-index", True)
→ index_clone("my-index", "my-index-clone")
→ index_set_readonly("my-index", False)

# Shrink an index (need to prepare)
→ index_prepare_for_shrink("my-index")
→ index_shrink("my-index", "my-index-shrunk", {"index.number_of_shards": 1})

# Rollover an index (need a writable alias)
→ index_create_with_write_alias("logs-000001", "logs")
→ index_rollover("logs", conditions={"max_docs": 1000000})

Environment Variables

Development

# Clone the repository
git clone https://github.com/cloudsmithy/easysearch-mcp-server.git
cd easysearch-mcp-server

# Install dependencies
pip install -e .

# Run tests
pytest

# Code formatting
black src/
ruff check src/

Compatibility Testing

All 121 tools have been tested and verified on INFINI Easysearch:

⚠️ Important Note

The snapshot and SLM functions require the server to configure path.repo to create a repository.

📄 License

MIT License