Skip to main content

deepset-mcp

The official MCP server and Python SDK for the deepset AI platform

deepset-mcp enables AI agents to build and debug pipelines on the Haystack Enterprise AI platform through 30+ specialized tools. It also provides a Python SDK for programmatic access to many platform resources.

Documentation

📖 View the full documentation

Quick Links

Development

Installation

Install the project using uv:

# Install uv first
pipx install uv

# Install project with all dependencies
uv sync --locked --all-extras --all-groups

Local Development

If you want to test your changes locally, follow these steps:

  1. Add a script run-deepset-mcp.sh that uses the binary from the project's virtual env
#!/usr/bin/env bash
# Wrapper to run the local deepset-mcp server for Cursor MCP.
# Use this as command so it doesn't depend on uv or PATH.
set -e
cd "$(dirname "$0")"
exec .venv/bin/deepset-mcp
  1. Use it this way in Cursor:
    "deepset": {
      "command": "/bin/bash",
      "args": ["/Users/*****/****/deepset-mcp-server/run-deepset-mcp.sh"],
      "cwd": "/Users/*****/****/deepset-mcp-server",
      "env": {
        "DEEPSET_WORKSPACE": "WORKSPACE",
        "DEEPSET_API_KEY": "API_KEY"
      }
    }

Note: If you change the codebase, make sure to restart the MCP server.

Code Quality & Testing

Run code quality checks and tests using the Makefile:

# Install dependencies
make install

# Code quality
make lint          # Run ruff linting
make format        # Format code with ruff
make types         # Run mypy type checking

# Testing
make test          # Run unit tests (default)
make test-unit     # Run unit tests only
make test-integration     # Run integration tests
make test-all      # Run all tests

# Clean up
make clean         # Remove cache files

Documentation

Documentation is built using MkDocs with the Material theme:

  • Configuration: mkdocs.yml
  • Content: docs/ directory
  • Auto-generated API docs via mkdocstrings
  • Deployed via GitHub Pages (automated via GitHub Actions on push to main branch)

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

deepset_mcp-0.1.21.tar.gz (25.5 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

deepset_mcp-0.1.21-py3-none-any.whl (128.1 kB view details)

Uploaded Python 3

File details

Details for the file deepset_mcp-0.1.21.tar.gz.

File metadata

  • Download URL: deepset_mcp-0.1.21.tar.gz
  • Upload date:
  • Size: 25.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for deepset_mcp-0.1.21.tar.gz
Algorithm Hash digest
SHA256 9994f037e85618e85aeb5df0c70955f4c0c0288bb7ce1c871444aeac9a59f971
MD5 9f0e57f62eac513d2b5330eb9ddfe689
BLAKE2b-256 eb5907d24a3db6ae5333fd45a70ae957caf7d3498748cb406c3eeac61a2da7c3

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepset_mcp-0.1.21.tar.gz:

Publisher: pypi_release.yml on deepset-ai/deepset-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file deepset_mcp-0.1.21-py3-none-any.whl.

File metadata

  • Download URL: deepset_mcp-0.1.21-py3-none-any.whl
  • Upload date:
  • Size: 128.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for deepset_mcp-0.1.21-py3-none-any.whl
Algorithm Hash digest
SHA256 a5edbce1d4e3ab192b1136cf5c14e2b4705dd2440b4f26fb92b29b536d26ea0e
MD5 0e214eebdee44c0d84f4e17631737265
BLAKE2b-256 6bf1ecba138ab858007ecfaa01e96f25ef26aa41e021e8d6c45b6b13a31e3d5b

See more details on using hashes here.

Provenance

The following attestation bundles were made for deepset_mcp-0.1.21-py3-none-any.whl:

Publisher: pypi_release.yml on deepset-ai/deepset-mcp-server

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page