OpenSearch MCP Server
Overview
This Repository Fork of elastic-mcp-server and Converted to opensearch-mcp-server MCP Server. It is a Model Context Protocol (MCP) server implementation that provides opensearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.
A Model Context Protocol (MCP) server implementation that provides opensearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.
Features
Index Operations
list_indices: List all indices in the Opensearch cluster.get_mapping: Retrieve the mapping configuration for a specific index.get_settings: Get the settings configuration for a specific index.
Document Operations
search_documents: Search documents in an index using Opensearch Query DSL.
Cluster Operations
get_cluster_health: Get health status of the cluster.get_cluster_stats: Get statistical information about the cluster.
Start Opensearch Cluster
Start the Opensearch cluster using Docker Compose:
docker-compose up -d
This will start a 3-node Opensearch cluster and Kibana. Default Opensearch username opensearch, password test123.
You can access Kibana from http://localhost:5601.
Usage with Claude Desktop
Using uv with local development
Using uv requires cloning the repository locally and specifying the path to the source code. Add the following configuration to Claude Desktop's config file claude_desktop_config.json.
you need to change path/to/src/opensearch_mcp_server to the path where you cloned the repository.
{
"mcpServers": {
"opensearch": {
"command": "uv",
"args": [
"--directory",
"path/to/src/opensearch_mcp_server",
"run",
"opensearch-mcp-server"
],
"env": {
"OPENSEARCH_HOST": "https://localhost:9200",
"OPENSEARCH_USERNAME": "opensearch",
"OPENSEARCH_PASSWORD": "test123",
"DASHBOARDS_HOST": "https://localhost:5601"
}
}
}
}
- On macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - On Windows:
%APPDATA%/Claude/claude_desktop_config.json
Restart Claude Desktop to load the new MCP server.
Now you can interact with your Opensearch cluster through Claude using natural language commands like:
- "List all indices in the cluster"
- "How old is the student Bob?"
- "Show me the cluster health status"
License
This project is licensed under the Apache License Version 2.0 - see the LICENSE file for details.
Metadata
Release files for iflow-mcp_seohyunjun_opensearch-mcp-server 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0.tar.gz | 35.6 kB | Without provenance | Details for iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0-py3-none-any.whl |
Total release size: 55.7 kB
Release files / iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0.tar.gz
| Download URL | iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0.tar.gz |
|---|---|
| Size | 35.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4f1eb908a90a9547f9ca2d533989f56e82aeaacad70488dbb3c15178d0f60cfe
|
|
BLAKE2b-256 checksum How to use checksums |
0ac2ceea1b09ee3ef30bff65707ff9ad991332b58ab493a6bb64e5780ca78f2d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0-py3-none-any.whl
| Download URL | iflow_mcp_seohyunjun_opensearch_mcp_server-1.0.0-py3-none-any.whl |
|---|---|
| Size | 20.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bbdf9adfed7664b9181e5f8305476cb4b7ee30a2dfd88af0d5650066e3790eb0
|
|
BLAKE2b-256 checksum How to use checksums |
90a4ec0478808627dd7914444f3e7f7c5ea109880c27c2ddb276069fc9270967
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_seohyunjun_opensearch-mcp-server 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.