Integrations
Utilizes environment variables through .env files to configure connection details for Elasticsearch, including host address, authentication credentials, and server port settings.
Enables interaction with Elasticsearch 7.x instances, supporting basic operations like ping and info, as well as complete search functionality including aggregation queries, highlighting, sorting, and other advanced search features.
Supports connection to Kibana as part of an Elasticsearch deployment through the Docker Compose setup, providing visualization and management capabilities for Elasticsearch data.
Elasticsearch 7.x MCP Server
An MCP server for Elasticsearch 7.x, providing compatibility with Elasticsearch 7.x versions.
Features
- Provides an MCP protocol interface for interacting with Elasticsearch 7.x
- Supports basic Elasticsearch operations (ping, info, etc.)
- Supports complete search functionality, including aggregation queries, highlighting, sorting, and other advanced features
- Easily access Elasticsearch functionality through any MCP client
Requirements
- Python 3.10+
- Elasticsearch 7.x (7.17.x recommended)
Installation
Installing via Smithery
To install Elasticsearch 7.x MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
Environment Variables
The server requires the following environment variables:
ELASTIC_HOST
: Elasticsearch host address (e.g., http://localhost:9200)ELASTIC_USERNAME
: Elasticsearch usernameELASTIC_PASSWORD
: Elasticsearch passwordMCP_PORT
: (Optional) MCP server listening port, default 9999
Using Docker Compose
- Create a
.env
file and setELASTIC_PASSWORD
:
- Start the services:
This will start a three-node Elasticsearch 7.17.10 cluster, Kibana, and the MCP server.
Using an MCP Client
You can use any MCP client to connect to the MCP server:
API Documentation
Currently supported MCP methods:
es-ping
: Check Elasticsearch connectiones-info
: Get Elasticsearch cluster informationes-search
: Search documents in Elasticsearch index
Search API Examples
Basic Search
Aggregation Query
Advanced Search
Development
- Clone the repository
- Install development dependencies
- Run the server:
elasticsearch7-mcp-server
License
[License in LICENSE file]
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides an MCP protocol interface for interacting with Elasticsearch 7.x databases, supporting comprehensive search functionality including aggregations, highlighting, and sorting.
- Features
- Requirements
- Installation
- Environment Variables
- Using Docker Compose
- Using an MCP Client
- API Documentation
- Development
- License
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityFacilitates interaction with Elasticsearch clusters by allowing users to perform index operations, document searches, and cluster management via a Model Context Protocol server and natural language commands.Last updated -6113PythonApache 2.0
- -securityFlicense-qualityA Python MCP server that enables semantic search through Search Labs blog posts indexed in Elasticsearch, allowing Claude to intelligently retrieve relevant information from the blog content.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that enables LLMs to interact with Elasticsearch clusters, allowing them to manage indices and execute search queries using natural language.Last updated -1JavaScript
- -securityAlicense-qualityMCP server for using various search tools like Tavily API. Planning to support various search tools (i.e. wiki search, searxng, etc)Last updated -1PythonMIT License