deepset-mcp 0.0.10__tar.gz → 0.0.12__tar.gz

{deepset_mcp-0.0.10 → deepset_mcp-0.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepset-mcp
-Version: 0.0.10
+Version: 0.0.12
 Summary: Collection of MCP tools and Agents to work with the deepset AI platform. Create, debug or learn about pipelines on the platform. Useable from the CLI, Cursor, Claude Code, or other MCP clients.
 Project-URL: Homepage, https://deepset.ai
 Author-email: Mathis Lucka <mathis.lucka@deepset.ai>, Tanay Soni <tanay.soni@deepset.ai>

deepset_mcp-0.0.12/entrypoint.sh

@@ -0,0 +1,26 @@
+#!/bin/sh
+# SPDX-FileCopyrightText: 2025-present deepset GmbH <info@deepset.ai>
+#
+# SPDX-License-Identifier: Apache-2.0
+
+# entrypoint.sh
+
+# 1) Change into the app dir
+cd /app
+
+# 2) Make sure we use the venv's Python
+PYTHON_BIN=/app/.venv/bin/python
+
+# 3) Point Python at the src/ directory so it can import deepset_mcp
+export PYTHONPATH=/app/src
+
+# 4) Exec your MCP server
+# If no command-line arguments are provided, use environment variables as defaults
+if [ $# -eq 0 ]; then
+  exec "$PYTHON_BIN" -m deepset_mcp.main \
+    --workspace "${DEEPSET_WORKSPACE}" \
+    --api-key   "${DEEPSET_API_KEY}"
+else
+  # Pass through all command-line arguments
+  exec "$PYTHON_BIN" -m deepset_mcp.main "$@"
+fi

{deepset_mcp-0.0.10 → deepset_mcp-0.0.12}/src/deepset_mcp/main.py

@@ -112,6 +112,20 @@ def main(
             "Can also be set via OBJECT_STORE_TTL environment variable.",
         ),
     ] = 600,
+    host: Annotated[
+        str,
+        typer.Option(
+            "--host",
+            help="Host address to bind the server to. Default: 0.0.0.0",
+        ),
+    ] = "0.0.0.0",
+    port: Annotated[
+        int | None,
+        typer.Option(
+            "--port",
+            help="Port number to bind the server to. If not specified, uses default port for the transport.",
+        ),
+    ] = None,
 ) -> None:
     """
     Run the Deepset MCP server.
@@ -130,6 +144,8 @@ def main(
     :param object_store_backend: Object store backend type ('memory' or 'redis')
     :param object_store_redis_url: Redis connection URL (required if backend='redis')
     :param object_store_ttl: TTL in seconds for stored objects
+    :param host: Host address to bind the server to
+    :param port: Port number to bind the server to
     """
     # Handle --list-tools flag early
     if list_tools:
@@ -187,6 +203,9 @@ def main(
         object_store_redis_url=redis_url,
         object_store_ttl=ttl,
     )
+    mcp.settings.host = host
+    if port is not None:
+        mcp.settings.port = port
 
     mcp.run(transport=transport.value)
 

{deepset_mcp-0.0.10 → deepset_mcp-0.0.12}/src/deepset_mcp/mcp/tool_registry.py

@@ -37,6 +37,7 @@ from deepset_mcp.tools.pipeline import (
     get_pipeline_logs as get_pipeline_logs_tool,
     list_pipelines as list_pipelines_tool,
     search_pipeline as search_pipeline_tool,
+    search_pipeline_with_filters as search_pipeline_with_filters_tool,
     update_pipeline as update_pipeline_tool,
     validate_pipeline as validate_pipeline_tool,
 )
@@ -128,6 +129,10 @@ TOOL_REGISTRY: dict[str, tuple[Callable[..., Any], ToolConfig]] = {
         search_pipeline_tool,
         ToolConfig(needs_client=True, needs_workspace=True, memory_type=MemoryType.EXPLORABLE),
     ),
+    "search_pipeline_with_filters": (
+        search_pipeline_with_filters_tool,
+        ToolConfig(needs_client=True, needs_workspace=True, memory_type=MemoryType.EXPLORABLE),
+    ),
     "list_indexes": (
         list_indexes_tool,
         ToolConfig(needs_client=True, needs_workspace=True, memory_type=MemoryType.EXPLORABLE),

{deepset_mcp-0.0.10 → deepset_mcp-0.0.12}/src/deepset_mcp/tools/__init__.py

@@ -20,6 +20,7 @@ from .pipeline import (
     get_pipeline_logs,
     list_pipelines,
     search_pipeline,
+    search_pipeline_with_filters,
     update_pipeline,
     validate_pipeline,
 )
@@ -49,6 +50,7 @@ __all__ = [
     "get_pipeline_logs",
     "deploy_pipeline",
     "search_pipeline",
+    "search_pipeline_with_filters",
     "create_pipeline",
     "update_pipeline",
     "validate_pipeline",

{deepset_mcp-0.0.10 → deepset_mcp-0.0.12}/src/deepset_mcp/tools/pipeline.py

@@ -3,6 +3,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 import asyncio
+from typing import Any
 
 import yaml
 from pydantic import BaseModel
@@ -367,3 +368,52 @@ async def search_pipeline(
         return f"Failed to search using pipeline '{pipeline_name}': {e}"
     except Exception as e:
         return f"An unexpected error occurred while searching with pipeline '{pipeline_name}': {str(e)}"
+
+
+async def search_pipeline_with_filters(
+    *,
+    client: AsyncClientProtocol,
+    workspace: str,
+    pipeline_name: str,
+    query: str,
+    filters: dict[str, Any] | None = None,
+) -> DeepsetSearchResponse | str:
+    """Searches using a pipeline with filters.
+
+    Uses the specified pipeline to perform a search with the given query and filters.
+    Filters follow the Haystack filter syntax: https://docs.haystack.deepset.ai/docs/metadata-filtering.
+    Before executing the search, checks if the pipeline is deployed (status = DEPLOYED).
+    Returns search results.
+
+    :param client: The async client for API communication.
+    :param workspace: The workspace name.
+    :param pipeline_name: Name of the pipeline to use for search.
+    :param query: The search query to execute.
+    :param filters: The filters to apply to the search.
+
+    :returns: Search results or error message.
+    """
+    try:
+        # First, check if the pipeline exists and get its status
+        pipeline = await client.pipelines(workspace=workspace).get(pipeline_name=pipeline_name)
+
+        # Check if pipeline is deployed
+        if pipeline.status != "DEPLOYED":
+            return (
+                f"Pipeline '{pipeline_name}' is not deployed (current status: {pipeline.status}). "
+                f"Please deploy the pipeline first using the deploy_pipeline tool before attempting to search."
+            )
+
+        # Execute the search
+        return await client.pipelines(workspace=workspace).search(
+            pipeline_name=pipeline_name, query=query, filters=filters if filters is not None else None
+        )
+
+    except ResourceNotFoundError:
+        return f"There is no pipeline named '{pipeline_name}' in workspace '{workspace}'."
+    except BadRequestError as e:
+        return f"Failed to search using pipeline '{pipeline_name}': {e}"
+    except UnexpectedAPIError as e:
+        return f"Failed to search using pipeline '{pipeline_name}': {e}"
+    except Exception as e:
+        return f"An unexpected error occurred while searching with pipeline '{pipeline_name}': {str(e)}"

deepset_mcp-0.0.10/entrypoint.sh

@@ -1,20 +0,0 @@
-#!/bin/sh
-# SPDX-FileCopyrightText: 2025-present deepset GmbH <info@deepset.ai>
-#
-# SPDX-License-Identifier: Apache-2.0
-
-# entrypoint.sh
-
-# 1) Change into the app dir
-cd /app
-
-# 2) Make sure we use the venv’s Python
-PYTHON_BIN=/app/.venv/bin/python
-
-# 3) Point Python at the src/ directory so it can import deepset_mcp
-export PYTHONPATH=/app/src
-
-# 4) Exec your MCP server
-exec "$PYTHON_BIN" -m deepset_mcp.main \
-  --workspace "${DEEPSET_WORKSPACE}" \
-  --api-key   "${DEEPSET_API_KEY}"