bintocher/mcp-superset

What's Changed

Added

• Bulk role operations (4 new tools):
  • superset_bulk_user_role_add — add a role to multiple users (by user IDs or by current role filter)
  • superset_bulk_user_role_remove — remove a role from multiple users (prevents removing last role)
  • superset_bulk_user_role_replace — replace one role with another for all users who have it
  • superset_role_copy_permissions — copy all permissions from one role to another
  • All bulk operations support dry-run mode and exclude Admin users by default
• Improved permissions audit (superset_permissions_audit):
  • Now checks both dashboard visibility (via dashboard.roles) AND datasource_access
  • Three access states: 1 (full access), 0 (no access), "visible_no_data" (can open dashboard but charts fail)

Changed

• Total tools: 137 (was 133)

Full Changelog: https://github.com/bintocher/mcp-superset/blob/main/CHANGELOG.md

What's New

Added

• Health check endpoint: GET /health — returns server status, version, and Superset URL (no auth required)
• PEP 561 py.typed marker for typed package support
• CONTRIBUTING.md with development setup and contribution guidelines
• SECURITY.md with responsible disclosure policy
• GitHub templates for bug reports, feature requests, and pull requests
• Dependabot configuration for automated dependency updates
• Pre-commit hooks configuration (ruff lint/format, trailing whitespace, YAML validation)
• CodeQL security scanning workflow

Changed

• All comments, docstrings, and error messages translated to English
• Google-style docstrings added to all public functions and methods

Install / Upgrade

pip install --upgrade mcp-superset
# or
uvx mcp-superset

What's Changed

Breaking

• Renamed package: superset_mcp → mcp_superset (import name), superset-mcp → mcp-superset (PyPI name)
• Update imports: from mcp_superset import ... and CLI: python -m mcp_superset

Updated

• Updated GitHub Actions to latest versions (checkout@v6, setup-uv@v7, upload-artifact@v6)
• Fixed Makefile references to new package name

Migration

# Uninstall old package (if installed)
pip uninstall superset-mcp

# Install new package
pip install mcp-superset

# Or run directly
uvx mcp-superset

mcp-superset v0.1.0

Comprehensive MCP server for Apache Superset with 128+ tools.

Highlights

• Full Superset 6.0.1 REST API coverage: dashboards, charts, datasets, databases, SQL Lab, security, RLS, groups, tags, reports, annotations, audit, asset management
• JWT authentication with automatic token refresh and CSRF handling
• Built-in safety: 14 confirmation flag types, DDL/DML blocking, system role protection
• Automatic datasource_access synchronization
• Dashboard native filter management (add/update/delete/reset)
• Permissions audit tool (user x dashboards x datasets x RLS matrix)
• CLI with --host, --port, --transport, --env-file
• Streamable HTTP, SSE, and stdio transports
• Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP client

Install

pip install mcp-superset
# or
uvx mcp-superset

See README for full documentation.