Easysearch MCP Server

🚀 Easysearch MCP Server

AIエージェントがINFINI Easysearch（Elasticsearch/OpenSearch APIと互換性があります）を操作できるようにするMCPサーバーです。

✨ 主な機能

• 🔧 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 .

🚀 クイックスタート

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エージェントはEasysearchを直接操作できます。

• "クラスターの健康状態を確認する"
• "productsインデックスを作成する"
• "価格が100を超える商品を検索する"
• "各カテゴリの注文数を集計する"

📚 ツールリスト

クラスター管理 (8)

インデックス管理 (25)

エイリアス管理 (4)

テンプレート管理 (3)

ドキュメント操作 (11)

検索機能 (15)

CAT API (19)

ノード管理 (5)

スナップショット管理 (10)

スナップショットライフサイクル管理 SLM (6)

タスク管理 (3)

Ingest Pipeline (6)

ILM インデックスライフサイクル管理 (5)

その他 (1)

💻 使用例

クラスター監視

クラスターの健康状態を確認する
→ 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})

📚 環境変数

🔧 開発

# リポジトリをクローン
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