sugon-mcp-server-elasticsearch

# Elasticsearch MCP Server A Model Context Protocol (MCP) server for Elasticsearch, providing core Elasticsearch functionality through MCP tools. ## Features - **Search Operations**: Perform full-text search, term queries, and complex aggregations - **Index Management**: Create, delete, and manage Elasticsearch indices - **Document Operations**: Index, update, delete, and retrieve documents - **Cluster Information**: Get cluster health, stats, and node information - **Mapping Management**: Create and manage index mappings - **Template Management**: Manage index templates and component templates ## Installation ### From PyPI ```bash pip install mcp-server-elasticsearch ``` ### From Source ```bash git clone https://github.com/your-username/mcp-server-elasticsearch.git cd mcp-server-elasticsearch pip install -e . ``` ## Configuration Create a configuration file (e.g., `elastic-mcp.json5`) with your Elasticsearch connection details: ```json5 { "elasticsearch": { "hosts": ["http://localhost:9200"], "username": "your_username", // optional "password": "your_password", // optional "api_key": "your_api_key", // optional, alternative to username/password "verify_certs": true, "ca_certs": "/path/to/ca.pem", // optional "timeout": 30 }, "server": { "host": "localhost", "port": 8000, "log_level": "INFO" } } ``` ## Usage ### As a Standalone Server ```bash # Using configuration file elasticsearch-mcp-server --config elastic-mcp.json5 # Using environment variables export ELASTICSEARCH_HOSTS=http://localhost:9200 export ELASTICSEARCH_USERNAME=your_username export ELASTICSEARCH_PASSWORD=your_password elasticsearch-mcp-server ``` ### As a Python Module ```python from elasticsearch_mcp_server import ElasticsearchMCPServer, ElasticsearchConfig # Load configuration config = ElasticsearchConfig.from_file("elastic-mcp.json5") # Create and run server server = ElasticsearchMCPServer(config) await server.run_stdio() ```…