Docker superset mcp no such command on latest

[japrogramer]

Bug description

Here is the error from the mcp client

MCP Server Error: failed to initialize server: failed to create client: failed to start client: unexpected status code: 502

and this is what is server side.

  2026-05-05 02:38:16,370:INFO:superset.app:Configuration sync to database completed successfully
  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  Superset 6.0.1
  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  
  superset@159f336abbd3:/app$ superset mcp run --host 0.0.0.0 --port 5008
  Loaded your LOCAL configuration at [/app/pythonpath/superset_config.py]
  /app/.venv/lib/python3.10/site-packages/flask_limiter/extension.py:324: UserWarning: Using the in-memory storage for tracking rate limits as no storage was explicitly specified. This is not recommended for production use. See: https://flask-limiter.readthedocs.io#configuring-a-storage-backend for documentation about configuring the storage backend.
    warnings.warn(
  2026-05-05 02:38:54,136:INFO:alembic.runtime.migration:Context impl SQLiteImpl.
  2026-05-05 02:38:54,137:INFO:alembic.runtime.migration:Will assume non-transactional DDL.
  2026-05-05 02:38:54,464:INFO:superset.app:Syncing configuration to database…
  2026-05-05 02:38:54,473:INFO:superset.app:Configuration sync to database completed successfully
  Usage: superset [OPTIONS] COMMAND [ARGS]…
  Try 'superset --help' for help.
  
  Error: No such command ‘mcp’.

copied docker compose from https://superset.apache.org/admin-docs/configuration/mcp-server/

# docker-compose.yml
services:
  superset:
    image: apache/superset:latest
    ports:
      - "8088:8088"
    volumes:
      - ./superset_config.py:/app/superset_config.py
    environment:
      - SUPERSET_CONFIG_PATH=/app/superset_config.py

  mcp:
    image: apache/superset:latest
    command: ["superset", "mcp", "run", "--host", "0.0.0.0", "--port", "5008"]
    ports:
      - "5008:5008"
    volumes:
      - ./superset_config.py:/app/superset_config.py
    environment:
      - SUPERSET_CONFIG_PATH=/app/superset_config.py
    depends_on:
      - superset

Screenshots/recordings

No response

Superset version

master / latest-dev

Python version

3.9

Node version

16

Browser

Chrome

Additional context

No response

Checklist

• I have searched Superset docs and Slack and didn't find a solution to my problem.
• I have searched the GitHub issue tracker and didn't find a similar bug report.
• I have checked Superset's logs for errors and if I found a relevant Python stacktrace, I included it here as text in the "additional context" section.

[japrogramer]

I also noticed that the docker container which uses uv pip doesn’t have fastmcp installed

Apache Superset 5.0+ running and accessible
Python 3.10+
The fastmcp package (pip install fastmcp)

so I created a dockerfile to create a new image with fastmcp but still superset says the command isn’t valid

[dosubot]

Hi @japrogramer! I'm Dosu and I’m helping the superset team.

That confirms what I found earlier — even with fastmcp installed, the superset mcp CLI command won't work because the MCP command itself isn't registered anywhere in the Superset codebase. The latest released version is v5.0.0, and there's no MCP-related code (no superset/cli/mcp.py, no superset/mcp/ module) in the repository [1]. Simply adding the fastmcp package won't help since there's no Superset code that uses it.

The documentation at superset.apache.org/admin-docs/configuration/mcp-server/ appears to describe a feature that hasn't been implemented or released yet. Installing fastmcp is a prerequisite listed in those docs, but the actual Superset-side integration (the CLI command and MCP service code) doesn't exist in any available version.

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.

[japrogramer]

@dosu which branch of the code should I use to try out the mcp ? or what is the latest release candidate with the MCP feature.

[dosubot]

Based on my research, the MCP code has not been merged into the main branch and is not included in any released version or release candidate. However, there are several MCP-related branches in the repository with active development [1].

The most relevant branch to try would be mcp-v1 (last updated Sep 16, 2025), which appears to be the main integration branch for the MCP feature. There's also mcp_service_max_dev (Jul 31, 2025) which seems to be an earlier development branch.

More recently, there are several feature/fix branches (updated April–May 2026) like amin/upgrade-fastmcp-3.2.4, fix/mcp-exclude-self-referencing-filter-columns-from-schema, and others — these suggest active ongoing work [1].

There are no 6.x release candidates — the latest release is v5.0.0 (June 2025). So despite the documentation being published at superset.apache.org/admin-docs/configuration/mcp-server/, the feature hasn't made it into any official release yet.

To try it out, I'd suggest building from the mcp-v1 branch (or one of the more recent fix branches if you want the latest iteration) and installing fastmcp manually, since it's listed as an optional dependency not included in the base requirements [2].

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.