elasticsearch-mcp-server 2.0.14__tar.gz → 2.0.16__tar.gz

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: elasticsearch-mcp-server
-Version: 2.0.14
+Version: 2.0.16
 Summary: MCP Server for interacting with Elasticsearch and OpenSearch
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -210,6 +210,7 @@ Requires-Dist: elasticsearch==8.17.2
 Requires-Dist: fastmcp==2.8.0
 Requires-Dist: mcp==1.9.2
 Requires-Dist: opensearch-py==2.8.0
+Requires-Dist: pydantic<2.12.0,>=2.11.0
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: tomli-w==1.2.0
 Requires-Dist: tomli==2.2.1
@@ -248,6 +249,9 @@ https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15
 - `get_index`: Returns information (mappings, settings, aliases) about one or more indices.
 - `create_index`: Create a new index.
 - `delete_index`: Delete an index.
+- `create_data_stream`: Create a new data stream (requires matching index template).
+- `get_data_stream`: Get information about one or more data streams.
+- `delete_data_stream`: Delete one or more data streams and their backing indices.
 
 ### Document Operations
 
@@ -372,7 +376,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "elasticsearch-mcp-server"
       ],
@@ -392,7 +396,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "elasticsearch-mcp-server"
       ],
@@ -411,7 +415,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "opensearch-mcp-server"
       ],
@@ -489,11 +493,7 @@ uv run src/server.py elasticsearch-mcp-server --transport streamable-http --host
 
 ## Compatibility
 
-The MCP server is compatible with Elasticsearch 7.x, 8.x, and 9.x. By default, it uses the Elasticsearch 8.x client (without a suffix). To use the Elasticsearch 7.x client, run the `elasticsearch-mcp-server-es7` variant. For Elasticsearch 9.x, use `elasticsearch-mcp-server-es9`. For example:
-
-```bash
-uvx elasticsearch-mcp-server-es7
-```
+The MCP server is compatible with Elasticsearch 7.x, 8.x, and 9.x. By default, it uses the Elasticsearch 8.x client (without a suffix).
 
 | MCP Server | Elasticsearch |
 | --- | --- |
@@ -502,6 +502,18 @@ uvx elasticsearch-mcp-server-es7
 | elasticsearch-mcp-server-es9 | Elasticsearch 9.x |
 | opensearch-mcp-server | OpenSearch 1.x, 2.x, 3.x |
 
+ To use the Elasticsearch 7.x client, run the `elasticsearch-mcp-server-es7` variant. For Elasticsearch 9.x, use `elasticsearch-mcp-server-es9`. For example:
+
+```bash
+uvx elasticsearch-mcp-server-es7
+```
+
+If you want to run different Elasticsearch variants (e.g., 7.x or 9.x) locally, simply update the `elasticsearch` dependency version in `pyproject.toml`, then start the server with:
+
+```bash
+uv run src/server.py elasticsearch-mcp-server
+```
+
 ## License
 
 This project is licensed under the Apache License Version 2.0 - see the [LICENSE](LICENSE) file for details.

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/README.md

@@ -31,6 +31,9 @@ https://github.com/user-attachments/assets/f7409e31-fac4-4321-9c94-b0ff2ea7ff15
 - `get_index`: Returns information (mappings, settings, aliases) about one or more indices.
 - `create_index`: Create a new index.
 - `delete_index`: Delete an index.
+- `create_data_stream`: Create a new data stream (requires matching index template).
+- `get_data_stream`: Get information about one or more data streams.
+- `delete_data_stream`: Delete one or more data streams and their backing indices.
 
 ### Document Operations
 
@@ -155,7 +158,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "elasticsearch-mcp-server"
       ],
@@ -175,7 +178,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "elasticsearch-mcp-server"
       ],
@@ -194,7 +197,7 @@ Using `uv` requires cloning the repository locally and specifying the path to th
       "command": "uv",
       "args": [
         "--directory",
-        "path/to/src/elasticsearch_mcp_server",
+        "path/to/elasticsearch-mcp-server",
         "run",
         "opensearch-mcp-server"
       ],
@@ -272,11 +275,7 @@ uv run src/server.py elasticsearch-mcp-server --transport streamable-http --host
 
 ## Compatibility
 
-The MCP server is compatible with Elasticsearch 7.x, 8.x, and 9.x. By default, it uses the Elasticsearch 8.x client (without a suffix). To use the Elasticsearch 7.x client, run the `elasticsearch-mcp-server-es7` variant. For Elasticsearch 9.x, use `elasticsearch-mcp-server-es9`. For example:
-
-```bash
-uvx elasticsearch-mcp-server-es7
-```
+The MCP server is compatible with Elasticsearch 7.x, 8.x, and 9.x. By default, it uses the Elasticsearch 8.x client (without a suffix).
 
 | MCP Server | Elasticsearch |
 | --- | --- |
@@ -285,6 +284,18 @@ uvx elasticsearch-mcp-server-es7
 | elasticsearch-mcp-server-es9 | Elasticsearch 9.x |
 | opensearch-mcp-server | OpenSearch 1.x, 2.x, 3.x |
 
+ To use the Elasticsearch 7.x client, run the `elasticsearch-mcp-server-es7` variant. For Elasticsearch 9.x, use `elasticsearch-mcp-server-es9`. For example:
+
+```bash
+uvx elasticsearch-mcp-server-es7
+```
+
+If you want to run different Elasticsearch variants (e.g., 7.x or 9.x) locally, simply update the `elasticsearch` dependency version in `pyproject.toml`, then start the server with:
+
+```bash
+uv run src/server.py elasticsearch-mcp-server
+```
+
 ## License
 
 This project is licensed under the Apache License Version 2.0 - see the [LICENSE](LICENSE) file for details.

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "elasticsearch-mcp-server"
-version = "2.0.14"
+version = "2.0.16"
 description = "MCP Server for interacting with Elasticsearch and OpenSearch"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -10,6 +10,7 @@ dependencies = [
     "mcp==1.9.2",
     "python-dotenv==1.1.0",
     "fastmcp==2.8.0",
+    "pydantic>=2.11.0,<2.12.0",
     "anthropic==0.49.0",
     "tomli==2.2.1",
     "tomli-w==1.2.0",

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/cr7258/elasticsearch-mcp-server",
     "source": "github"
   },
-  "version": "2.0.14",
+  "version": "2.0.16",
   "packages": [
     {
       "registry_type": "pypi",
       "registry_base_url": "https://pypi.org",
       "identifier": "elasticsearch-mcp-server",
-      "version": "2.0.14",
+      "version": "2.0.16",
       "transport": {
         "type": "stdio"
       },

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/src/clients/base.py

@@ -91,6 +91,9 @@ class SearchClientBase(ABC):
         # Check Elasticsearch package version to determine auth parameter name
         try:
             from elasticsearch import __version__ as es_version
+            # Convert version tuple to string format
+            version_str = '.'.join(map(str, es_version))
+            self.logger.info(f"Elasticsearch client version: {version_str}")
             major_version = es_version[0]    
             if major_version >= 8:
                 # ES 8+ uses basic_auth

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/src/clients/common/client.py

@@ -2,11 +2,12 @@ from typing import Dict
 
 from src.clients.common.alias import AliasClient
 from src.clients.common.cluster import ClusterClient
+from src.clients.common.data_stream import DataStreamClient
 from src.clients.common.document import DocumentClient
 from src.clients.common.general import GeneralClient
 from src.clients.common.index import IndexClient
 
-class SearchClient(IndexClient, DocumentClient, ClusterClient, AliasClient, GeneralClient):
+class SearchClient(IndexClient, DocumentClient, ClusterClient, AliasClient, DataStreamClient, GeneralClient):
     """
     Unified search client that combines all search functionality.
     

elasticsearch_mcp_server-2.0.16/src/clients/common/data_stream.py

@@ -0,0 +1,18 @@
+from typing import Dict, Optional
+from src.clients.base import SearchClientBase
+
+class DataStreamClient(SearchClientBase):  
+    def create_data_stream(self, name: str) -> Dict:
+        """Create a new data stream."""
+        return self.client.indices.create_data_stream(name=name)
+    
+    def get_data_stream(self, name: Optional[str] = None) -> Dict:
+        """Get information about one or more data streams."""
+        if name:
+            return self.client.indices.get_data_stream(name=name)
+        else:
+            return self.client.indices.get_data_stream()
+    
+    def delete_data_stream(self, name: str) -> Dict:
+        """Delete one or more data streams."""
+        return self.client.indices.delete_data_stream(name=name)

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/src/server.py

@@ -7,6 +7,7 @@ from fastmcp import FastMCP
 from src.clients import create_search_client
 from src.tools.alias import AliasTools
 from src.tools.cluster import ClusterTools
+from src.tools.data_stream import DataStreamTools
 from src.tools.document import DocumentTools
 from src.tools.general import GeneralTools
 from src.tools.index import IndexTools
@@ -19,7 +20,13 @@ class SearchMCPServer:
         self.engine_type = engine_type
         self.name = f"{self.engine_type}-mcp-server"
         self.mcp = FastMCP(self.name)
-        self.logger = logging.getLogger()
+        
+        # Configure logging
+        logging.basicConfig(
+            level=logging.INFO,
+            format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
+        )
+        self.logger = logging.getLogger(__name__)
         self.logger.info(f"Initializing {self.name}, Version: {VERSION}")
         
         # Create the corresponding search client
@@ -39,6 +46,7 @@ class SearchMCPServer:
             DocumentTools,
             ClusterTools,
             AliasTools,
+            DataStreamTools,
             GeneralTools,
         ]        
         # Register all tools

elasticsearch_mcp_server-2.0.16/src/tools/data_stream.py

@@ -0,0 +1,47 @@
+from typing import Dict, Optional
+from fastmcp import FastMCP
+
+class DataStreamTools:    
+    def __init__(self, search_client):
+        self.search_client = search_client
+    
+    def register_tools(self, mcp: FastMCP):
+        """Register data stream tools with the MCP server."""
+        
+        @mcp.tool()
+        def create_data_stream(name: str) -> Dict:
+            """Create a new data stream.
+            
+            This creates a new data stream with the specified name.
+            The data stream must have a matching index template before creation.
+            
+            Args:
+                name: Name of the data stream to create
+            """
+            return self.search_client.create_data_stream(name=name)
+        
+        @mcp.tool()
+        def get_data_stream(name: Optional[str] = None) -> Dict:
+            """Get information about one or more data streams.
+            
+            Retrieves configuration, mappings, settings, and other information
+            about the specified data streams.
+            
+            Args:
+                name: Name of the data stream(s) to retrieve.
+                      Can be a comma-separated list or wildcard pattern.
+                      If not provided, retrieves all data streams.
+            """
+            return self.search_client.get_data_stream(name=name)
+        
+        @mcp.tool()
+        def delete_data_stream(name: str) -> Dict:
+            """Delete one or more data streams.
+            
+            Permanently deletes the specified data streams and all their backing indices.
+            
+            Args:
+                name: Name of the data stream(s) to delete.
+                      Can be a comma-separated list or wildcard pattern.
+            """
+            return self.search_client.delete_data_stream(name=name)

elasticsearch_mcp_server-2.0.16/src/version.py

@@ -0,0 +1 @@
+__version__ = "2.0.16"

{elasticsearch_mcp_server-2.0.14 → elasticsearch_mcp_server-2.0.16}/uv.lock

@@ -287,7 +287,7 @@ wheels = [
 
 [[package]]
 name = "elasticsearch-mcp-server"
-version = "2.0.14"
+version = "2.0.16"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },
@@ -295,6 +295,7 @@ dependencies = [
     { name = "fastmcp" },
     { name = "mcp" },
     { name = "opensearch-py" },
+    { name = "pydantic" },
     { name = "python-dotenv" },
     { name = "tomli" },
     { name = "tomli-w" },
@@ -307,6 +308,7 @@ requires-dist = [
     { name = "fastmcp", specifier = "==2.8.0" },
     { name = "mcp", specifier = "==1.9.2" },
     { name = "opensearch-py", specifier = "==2.8.0" },
+    { name = "pydantic", specifier = ">=2.11.0,<2.12.0" },
     { name = "python-dotenv", specifier = "==1.1.0" },
     { name = "tomli", specifier = "==2.2.1" },
     { name = "tomli-w", specifier = "==1.2.0" },

elasticsearch_mcp_server-2.0.14/src/version.py

@@ -1 +0,0 @@
-__version__ = "2.0.14"