opensearch-mcp-server 2.0.4__py3-none-any.whl → 2.0.6__py3-none-any.whl

{opensearch_mcp_server-2.0.4.dist-info → opensearch_mcp_server-2.0.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensearch-mcp-server
-Version: 2.0.4
+Version: 2.0.6
 Summary: MCP Server for interacting with Elasticsearch and OpenSearch
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -207,18 +207,21 @@ License-File: LICENSE
 Requires-Python: >=3.10
 Requires-Dist: anthropic==0.49.0
 Requires-Dist: elasticsearch==8.17.2
-Requires-Dist: fastmcp==0.4.1
-Requires-Dist: mcp==1.6.0
+Requires-Dist: fastmcp==2.8.0
+Requires-Dist: mcp==1.9.2
 Requires-Dist: opensearch-py==2.8.0
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: tomli-w==1.2.0
 Requires-Dist: tomli==2.2.1
 Description-Content-Type: text/markdown
 
+
 # Elasticsearch/OpenSearch MCP Server
 
 [![smithery badge](https://smithery.ai/badge/elasticsearch-mcp-server)](https://smithery.ai/server/elasticsearch-mcp-server)
 
+[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/cr7258-elasticsearch-mcp-server-badge.png)](https://mseep.ai/app/cr7258-elasticsearch-mcp-server)
+
 ## Overview
 
 A Model Context Protocol (MCP) server implementation that provides Elasticsearch and OpenSearch interaction. This server enables searching documents, analyzing indices, and managing cluster through a set of tools.
@@ -282,19 +285,11 @@ The default Elasticsearch username is `elastic` and password is `test123`. The d
 
 You can access Kibana/OpenSearch Dashboards from http://localhost:5601.
 
-## Usage with Claude Desktop
-
-### Option 1: Installing via Smithery
+## Stdio
 
-To install Elasticsearch Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/elasticsearch-mcp-server):
-
-```bash
-npx -y @smithery/cli install elasticsearch-mcp-server --client claude
-```
+### Option 1: Using uvx
 
-### Option 2: Using uvx
-
-Using `uvx` will automatically install the package from PyPI, no need to clone the repository locally. Add the following configuration to Claude Desktop's config file `claude_desktop_config.json`.
+Using `uvx` will automatically install the package from PyPI, no need to clone the repository locally. Add the following configuration to 's config file `claude_desktop_config.json`.
 
 ```json
 // For Elasticsearch
@@ -332,7 +327,7 @@ Using `uvx` will automatically install the package from PyPI, no need to clone t
 }
 ```
 
-### Option 3: Using uv with local development
+### Option 2: 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`.
 
@@ -378,20 +373,24 @@ Using `uv` requires cloning the repository locally and specifying the path to th
 }
 ```
 
-- On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
+## SSE
 
-Restart Claude Desktop to load the new MCP server.
+```bash
+# By default, the SSE MCP server will serve on http://127.0.0.1:8000/sse
+uv run src/server.py elasticsearch-mcp-server --transport sse
 
-Now you can interact with your Elasticsearch/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"
+# The host, port, and path can be specified using the --host, --port, and --path options
+uv run src/server.py elasticsearch-mcp-server --transport sse --host 0.0.0.0 --port 8000 --path /sse
+```
 
-## Usage with Anthropic MCP Client
+## Streamable HTTP
+
+```bash
+# By default, the Streamable HTTP MCP server will serve on http://127.0.0.1:8000/mcp
+uv run src/server.py elasticsearch-mcp-server --transport streamable-http
 
-```python
-uv run mcp_client/client.py src/server.py
+# The host, port, and path can be specified using the --host, --port, and --path options
+uv run src/server.py elasticsearch-mcp-server --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp
 ```
 
 ## License

{opensearch_mcp_server-2.0.4.dist-info → opensearch_mcp_server-2.0.6.dist-info}/RECORD

@@ -1,6 +1,6 @@
 src/__init__.py,sha256=aNKcThftSLh9IjOTA-UUpoRzIm4R0WwXKGAzykwecmU,211
-src/server.py,sha256=Gf5sPXmuG4Jos82ks0LPFNWWbMGEIUfoKm8ibOHmx_A,2287
-src/version.py,sha256=ZOg41aCgKEuObK5WhegikXektFWPJaeZ-TMDh0Ke95M,22
+src/server.py,sha256=BfMAgXTFV9C4waCWRro8Sfl6yXEXr2vJ7YoGY7HhMPY,5072
+src/version.py,sha256=4Yxft_MNOtwQG58mZpa8eoM0XBHa8VNkTPH9_i0gDaM,22
 src/clients/__init__.py,sha256=3UezAt9422S-7BvMiCo2Y9pmATVutorwsIQXP_g_CkA,1221
 src/clients/base.py,sha256=MBAGepXyHPtdbtHhxFB8CamZ2ApWCBuOi_6-ey-MqX8,3298
 src/clients/exceptions.py,sha256=NYF3KVw-9aAgCViin5OuBI6miMEPS5QsdHx6bcis1wc,2493
@@ -18,8 +18,8 @@ src/tools/document.py,sha256=XZTVuk4di9VEwWMZN7jyDVnzoOiXkb4FBrXF44sVXTs,2052
 src/tools/general.py,sha256=whj1spjIb8SS75h843X6c3RTsrZcSm-66KVLlY7OEh0,817
 src/tools/index.py,sha256=7KNPtElTFelkjRSvdMqPBx9nx_9Uk01OnTMeVo7YeCs,1345
 src/tools/register.py,sha256=wrG2P6-YPW77bTg1j_ELp8omWRYsJjFeOHUy_unHe6Y,1344
-opensearch_mcp_server-2.0.4.dist-info/METADATA,sha256=L_fxn1Xf85fqRa4eRfxOct1WJCdnVZA3fDT9SwxUtdc,18688
-opensearch_mcp_server-2.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-opensearch_mcp_server-2.0.4.dist-info/entry_points.txt,sha256=ImfJnUwMpQUBmu-1MeBG_P0dwamfXKQh82mBKW7tWNY,138
-opensearch_mcp_server-2.0.4.dist-info/licenses/LICENSE,sha256=DBsjuP5FR51d9kaUdXlVBuBv3cQ_I_adq9gefYQ9FcY,11339
-opensearch_mcp_server-2.0.4.dist-info/RECORD,,
+opensearch_mcp_server-2.0.6.dist-info/METADATA,sha256=szezVrGvLMf08Ajp-9r7Cww0m4VBKDbD3zU2KJC9wgQ,18791
+opensearch_mcp_server-2.0.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+opensearch_mcp_server-2.0.6.dist-info/entry_points.txt,sha256=ImfJnUwMpQUBmu-1MeBG_P0dwamfXKQh82mBKW7tWNY,138
+opensearch_mcp_server-2.0.6.dist-info/licenses/LICENSE,sha256=DBsjuP5FR51d9kaUdXlVBuBv3cQ_I_adq9gefYQ9FcY,11339
+opensearch_mcp_server-2.0.6.dist-info/RECORD,,

src/server.py

@@ -1,5 +1,6 @@
 import logging
 import sys
+import argparse
 
 from fastmcp import FastMCP
 
@@ -16,7 +17,7 @@ class SearchMCPServer:
     def __init__(self, engine_type):
         # Set engine type
         self.engine_type = engine_type
-        self.name = f"{self.engine_type}_mcp_server"
+        self.name = f"{self.engine_type}-mcp-server"
         self.mcp = FastMCP(self.name)
         self.logger = logging.getLogger()
         self.logger.info(f"Initializing {self.name}, Version: {VERSION}")
@@ -43,32 +44,115 @@ class SearchMCPServer:
         # Register all tools
         register.register_all_tools(tool_classes)
 
-    def run(self):
-        """Run the MCP server."""
-        self.mcp.run()
 
-def run_search_server(engine_type):
-    """Run search server with specified engine type."""
+def run_search_server(engine_type, transport, host, port, path):
+    """Run search server with specified engine type and transport options.
+    
+    Args:
+        engine_type: Type of search engine to use ("elasticsearch" or "opensearch")
+        transport: Transport protocol to use ("stdio", "streamable-http", or "sse")
+        host: Host to bind to when using HTTP transports
+        port: Port to bind to when using HTTP transports
+        path: URL path prefix for HTTP transports
+    """
+    
     server = SearchMCPServer(engine_type=engine_type)
-    server.run()
+    
+    if transport in ["streamable-http", "sse"]:
+        server.logger.info(f"Starting {server.name} with {transport} transport on {host}:{port}{path}")
+        server.mcp.run(transport=transport, host=host, port=port, path=path)
+    else:
+        server.logger.info(f"Starting {server.name} with {transport} transport")
+        server.mcp.run(transport=transport)
+
+def parse_server_args():
+    """Parse command line arguments for the MCP server.
+    
+    Returns:
+        Parsed arguments
+    """
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--transport", "-t",
+        default="stdio",
+        choices=["stdio", "streamable-http", "sse"],
+        help="Transport protocol to use (default: stdio)"
+    )
+    parser.add_argument(
+        "--host", "-H",
+        default="127.0.0.1",
+        help="Host to bind to when using HTTP transports (default: 127.0.0.1)"
+    )
+    parser.add_argument(
+        "--port", "-p",
+        type=int,
+        default=8000,
+        help="Port to bind to when using HTTP transports (default: 8000)"
+    )
+    parser.add_argument(
+        "--path", "-P",
+        help="URL path prefix for HTTP transports (default: /mcp for streamable-http, /sse for sse)"
+    )
+    
+    args = parser.parse_args()
+    
+    # Set default path based on transport type if not specified
+    if args.path is None:
+        if args.transport == "sse":
+            args.path = "/sse"
+        else:
+            args.path = "/mcp"
+            
+    return args
 
 def elasticsearch_mcp_server():
     """Entry point for Elasticsearch MCP server."""
-    run_search_server(engine_type="elasticsearch")
+    args = parse_server_args()
+    
+    # Run the server with the specified options
+    run_search_server(
+        engine_type="elasticsearch",
+        transport=args.transport,
+        host=args.host,
+        port=args.port,
+        path=args.path
+    )
 
 def opensearch_mcp_server():
     """Entry point for OpenSearch MCP server."""
-    run_search_server(engine_type="opensearch")
+    args = parse_server_args()
+    
+    # Run the server with the specified options
+    run_search_server(
+        engine_type="opensearch",
+        transport=args.transport,
+        host=args.host,
+        port=args.port,
+        path=args.path
+    )
 
 if __name__ == "__main__":
-    # Default to Elasticsearch
-    engine_type = "elasticsearch"
+    # Require elasticsearch-mcp-server or opensearch-mcp-server as the first argument
+    if len(sys.argv) <= 1 or sys.argv[1] not in ["elasticsearch-mcp-server", "opensearch-mcp-server"]:
+        print("Error: First argument must be 'elasticsearch-mcp-server' or 'opensearch-mcp-server'")
+        sys.exit(1)
+        
+    # Determine engine type based on the first argument
+    engine_type = "elasticsearch"  # Default
+    if sys.argv[1] == "opensearch-mcp-server":
+        engine_type = "opensearch"
+        
+    # Remove the first argument so it doesn't interfere with argparse
+    sys.argv.pop(1)
     
-    # If command line arguments are provided, use the first argument as the engine type
-    if len(sys.argv) > 1:
-        engine_type = sys.argv[1].lower()
+    # Parse command line arguments
+    args = parse_server_args()
     
-    if engine_type == "opensearch":
-        opensearch_mcp_server()
-    else:
-        elasticsearch_mcp_server()
+    # Run the server with the specified options
+    run_search_server(
+        engine_type=engine_type,
+        transport=args.transport,
+        host=args.host,
+        port=args.port,
+        path=args.path
+    )

src/version.py

@@ -1 +1 @@
-__version__ = "2.0.4"
+__version__ = "2.0.6"