Elasticsearch MCP 服务器

Name: Elasticsearch MCP 服务器
Author: macgaf

@macgaf

リポジトリ

Elasticsearch MCP 服务器について

elasticsearch mcp server and client, supports es7 and es8, based on Model Context Protocol python sdk

基本情報

カテゴリ

データベース

ライセンス

MIT license

ランタイム

python

トランスポート

stdio

公開者

macgaf

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "es-mcp-server-macgaf": {
      "command": "uvx",
      "args": [
        "es-mcp-server"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Elasticsearch MCP 服务器?

Elasticsearch MCP 服务器 is a tool server based on the Model Context Protocol (MCP) for Elasticsearch. It provides capabilities for listing indices, retrieving field mappings, executing search queries, and checking cluster health and stats. It is designed for developers and AI assistants that need to interact with Elasticsearch data.

How to use Elasticsearch MCP 服务器?

Install via pip (pip install es-mcp-server). Configure connection using environment variables (e.g., ES_HOST, ES_PORT, ES_API_KEY). Start the server in stdio mode (default) or SSE mode using uvx es-mcp-server with optional flags like --host, --port, --es-version, and --transport sse. Integrate with Claude Desktop by adding a stanza in its MCP configuration file.

Key features of Elasticsearch MCP 服务器

List all indices in an Elasticsearch cluster
Retrieve detailed field mappings for an index
Execute search queries with highlight support
Fetch cluster health status
Obtain cluster runtime statistics

Use cases of Elasticsearch MCP 服务器

Provide an AI assistant (e.g., Claude Desktop) with live Elasticsearch query capabilities
Allow developers to quickly inspect index schemas without a separate client
Monitor Elasticsearch cluster health and stats through natural language
Run ad-hoc searches and retrieve highlighted results for data exploration

FAQ from Elasticsearch MCP 服务器

Does it support both Elasticsearch 7 and 8?

Yes, the server works with both Elasticsearch 7 and 8 API versions. The version is configured via the ES_VERSION environment variable (default 8).

What transport modes are available?

The server supports stdio mode (default, for desktop integration) and SSE mode (for standalone web server). Use --transport sse to start in SSE mode.

How do I configure authentication?

Authentication can be set via environment variables: ES_USERNAME and ES_PASSWORD for basic auth, or ES_API_KEY for API key auth. SSL settings are controlled by ES_USE_SSL and ES_VERIFY_CERTS.

Can this server be used with Claude Desktop?

Yes. Claude Desktop can connect via MCP using either stdio mode (with the uvx command and environment variables) or SSE mode (by providing the SSE server URL).

What are the main dependencies?

The server requires Python and the es-mcp-server package (available on PyPI). It relies on the Elasticsearch client library for connectivity and the MCP Python SDK for protocol handling.