opensearch-mcp-server 2.0.3__py3-none-any.whl → 2.0.5__py3-none-any.whl

{opensearch_mcp_server-2.0.3.dist-info → opensearch_mcp_server-2.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opensearch-mcp-server
-Version: 2.0.3
+Version: 2.0.5
 Summary: MCP Server for interacting with Elasticsearch and OpenSearch
 License:                                  Apache License
                                    Version 2.0, January 2004
@@ -207,19 +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: toml==0.10.2
 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.
@@ -283,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
@@ -333,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`.
 
@@ -379,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 --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 --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 --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 --transport streamable-http --host 0.0.0.0 --port 8000 --path /mcp
 ```
 
 ## License

{opensearch_mcp_server-2.0.3.dist-info → opensearch_mcp_server-2.0.5.dist-info}/RECORD

@@ -1,5 +1,6 @@
 src/__init__.py,sha256=aNKcThftSLh9IjOTA-UUpoRzIm4R0WwXKGAzykwecmU,211
-src/server.py,sha256=2EyBWtdAIct-L589FXhxTfQswsgo9nusC9ZORVfwXWU,2330
+src/server.py,sha256=UTRN7Wk1njdLpF2Aa7G-dAyq04FOU3cGK1wNZGqSw3U,4154
+src/version.py,sha256=xEb7Z4b8xalXXExBg42XPAhbJKniHzcsEPjp-6S3ppg,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
@@ -17,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.3.dist-info/METADATA,sha256=OFMMCH1mufu1PkUACANPjp0fzWu3NSTtH6gVccB67r4,18716
-opensearch_mcp_server-2.0.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-opensearch_mcp_server-2.0.3.dist-info/entry_points.txt,sha256=ImfJnUwMpQUBmu-1MeBG_P0dwamfXKQh82mBKW7tWNY,138
-opensearch_mcp_server-2.0.3.dist-info/licenses/LICENSE,sha256=DBsjuP5FR51d9kaUdXlVBuBv3cQ_I_adq9gefYQ9FcY,11339
-opensearch_mcp_server-2.0.3.dist-info/RECORD,,
+opensearch_mcp_server-2.0.5.dist-info/METADATA,sha256=7XYxNvhAvMNagGh7GpYQUWb7qqLEJy0-JM200dp8S00,18747
+opensearch_mcp_server-2.0.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+opensearch_mcp_server-2.0.5.dist-info/entry_points.txt,sha256=ImfJnUwMpQUBmu-1MeBG_P0dwamfXKQh82mBKW7tWNY,138
+opensearch_mcp_server-2.0.5.dist-info/licenses/LICENSE,sha256=DBsjuP5FR51d9kaUdXlVBuBv3cQ_I_adq9gefYQ9FcY,11339
+opensearch_mcp_server-2.0.5.dist-info/RECORD,,

src/server.py

@@ -1,8 +1,8 @@
 import logging
 import sys
+import argparse
 
 from fastmcp import FastMCP
-import toml
 
 from src.clients import create_search_client
 from src.tools.alias import AliasTools
@@ -11,6 +11,7 @@ from src.tools.document import DocumentTools
 from src.tools.general import GeneralTools
 from src.tools.index import IndexTools
 from src.tools.register import ToolsRegister
+from src.version import __version__ as VERSION
 
 class SearchMCPServer:
     def __init__(self, engine_type):
@@ -19,8 +20,7 @@ class SearchMCPServer:
         self.name = f"{self.engine_type}_mcp_server"
         self.mcp = FastMCP(self.name)
         self.logger = logging.getLogger()
-        self.version = toml.load("pyproject.toml")["project"]["version"]
-        self.logger.info(f"Initializing {self.name}, Version: {self.version}")
+        self.logger.info(f"Initializing {self.name}, Version: {VERSION}")
         
         # Create the corresponding search client
         self.search_client = create_search_client(self.engine_type)
@@ -44,14 +44,26 @@ 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 elasticsearch_mcp_server():
     """Entry point for Elasticsearch MCP server."""
@@ -62,14 +74,51 @@ def opensearch_mcp_server():
     run_search_server(engine_type="opensearch")
 
 if __name__ == "__main__":
-    # Default to Elasticsearch
-    engine_type = "elasticsearch"
+    # Parse command line arguments
+    parser = argparse.ArgumentParser(description=f"Elasticsearch/OpenSearch MCP Server v{VERSION}")
+    parser.add_argument(
+        "engine_type", 
+        nargs="?", 
+        default="elasticsearch",
+        choices=["elasticsearch", "opensearch"], 
+        help="Search engine type to use (default: elasticsearch)"
+    )
+    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)"
+    )
     
-    # 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()
+    args = parser.parse_args()
     
-    if engine_type == "opensearch":
-        opensearch_mcp_server()
-    else:
-        elasticsearch_mcp_server()
+    # 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"
+    
+    # Run the server with the specified options
+    run_search_server(
+        engine_type=args.engine_type,
+        transport=args.transport,
+        host=args.host,
+        port=args.port,
+        path=args.path
+    )

src/version.py

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