{"id":39656099,"url":"https://github.com/openops-cloud/superset-mcp","last_synced_at":"2026-01-18T09:17:57.449Z","repository":{"id":293230641,"uuid":"983048950","full_name":"openops-cloud/superset-mcp","owner":"openops-cloud","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-14T09:24:13.000Z","size":117,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-14T10:44:58.777Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/openops-cloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-13T19:52:15.000Z","updated_at":"2025-05-14T09:24:16.000Z","dependencies_parsed_at":"2025-05-14T10:45:16.866Z","dependency_job_id":"4419e6bc-3203-4140-9375-b6d2657ffd08","html_url":"https://github.com/openops-cloud/superset-mcp","commit_stats":null,"previous_names":["openops-cloud/superset-mcp"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/openops-cloud/superset-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openops-cloud%2Fsuperset-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openops-cloud%2Fsuperset-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openops-cloud%2Fsuperset-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openops-cloud%2Fsuperset-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openops-cloud","download_url":"https://codeload.github.com/openops-cloud/superset-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openops-cloud%2Fsuperset-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28534156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T00:39:45.795Z","status":"online","status_checked_at":"2026-01-18T02:00:07.578Z","response_time":98,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-18T09:17:57.388Z","updated_at":"2026-01-18T09:17:57.439Z","avatar_url":"https://github.com/openops-cloud.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Superset MCP Integration\n[![smithery badge](https://smithery.ai/badge/@aptro/superset-mcp)](https://smithery.ai/server/@aptro/superset-mcp)\n\nMCP server for interacting with Apache Superset, enabling AI agents to connect to and control a Superset instance programmatically.\n\n## Setup Instructions\n\n### Installing via Smithery\n\nTo install Superset Integration for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@aptro/superset-mcp):\n\n```bash\nnpx -y @smithery/cli install @aptro/superset-mcp --client claude\n```\n\n### Manual Installation\n\n1. **Set Up Superset Locally**\n\n   Run this script to start Superset locally:\n   ```bash\n   git clone --branch 4.1.1 --depth 1 https://github.com/apache/superset \u0026\u0026 \\\n   cd superset \u0026\u0026 \\\n   docker compose -f docker-compose-image-tag.yml up\n   ```\n\n   Once Superset is running, you should be able to access it at http://localhost:8088 with default credentials:\n   - Username: admin\n   - Password: admin\n\n2. **Clone This Repository**\n\n   Clone this repository to your local machine.\n\n3. **Configure Environment Variables**\n\n   Create a `.env` file in the root directory with your Superset credentials:\n   ```\n   SUPERSET_BASE_URL=http://localhost:8088  # Change to your Superset URL\n   SUPERSET_USERNAME=your_username\n   SUPERSET_PASSWORD=your_password\n   ```\n\n4. **Install Dependencies**\n\n   ```bash\n   uv pip install .\n   ```\n\n5. **Install MCP Config for Claude**\n\n   To use with Claude Desktop app:\n   ```bash\n   mcp install main.py\n   ```\n\n## Usage with Claude\n\nAfter setup, you can interact with your Superset instance via Claude using natural language requests. Here are some examples:\n\n### Dashboard Management\n\n- **View dashboards**: \"Show me all my Superset dashboards\"\n- **Get dashboard details**: \"Show me the details of dashboard with ID 5\"\n- **Create dashboard**: \"Create a new dashboard titled 'Sales Overview'\"\n- **Update dashboard**: \"Update dashboard 3 to have the title 'Updated Sales Report'\"\n- **Delete dashboard**: \"Delete dashboard with ID 7\"\n\n### Chart Management\n\n- **List all charts**: \"What charts do I have in my Superset instance?\"\n- **View chart details**: \"Show me the details of chart with ID 10\"\n- **Create chart**: \"Create a new bar chart using dataset 3\"\n- **Update chart**: \"Update chart 5 to use a line visualization instead of bar\"\n- **Delete chart**: \"Delete chart with ID 12\"\n\n### Database and Dataset Operations\n\n- **List databases**: \"Show me all databases connected to Superset\"\n- **List datasets**: \"What datasets are available in my Superset instance?\"\n- **Get database tables**: \"What tables are available in database with ID 1?\"\n- **Execute SQL**: \"Run this SQL query on database 1: SELECT * FROM users LIMIT 10\"\n- **Create dataset**: \"Create a new dataset from table 'customers' in database 2\"\n- **Update database**: \"Update the connection settings for database 3\"\n- **Delete database**: \"Delete database connection with ID 4\"\n- **Validate SQL**: \"Is this SQL valid for database 2: SELECT * FROM customers JOIN orders\"\n- **Get database catalogs**: \"Show me the catalogs available in database 1\"\n- **Get database functions**: \"What functions are available in database 2?\"\n- **Check related objects**: \"What dashboards and charts use database 1?\"\n\n### SQL Lab Features\n\n- **Execute queries**: \"Run this SQL query: SELECT COUNT(*) FROM orders\"\n- **Format SQL**: \"Format this SQL query: SELECT id,name,age FROM users WHERE age\u003e21\"\n- **Estimate query cost**: \"Estimate the cost of this query: SELECT * FROM large_table\"\n- **Get saved queries**: \"Show me all my saved SQL queries\"\n- **Get query results**: \"Get the results of query with key 'abc123'\"\n\n### User and System Information\n\n- **View user info**: \"Who am I logged in as?\"\n- **Get user roles**: \"What roles do I have in Superset?\"\n- **View recent activity**: \"Show me recent activity in my Superset instance\"\n- **Get menu data**: \"What menu items do I have access to?\"\n- **Get base URL**: \"What is the URL of the Superset instance I'm connected to?\"\n\n### Tag Management\n\n- **List tags**: \"Show me all tags in my Superset instance\"\n- **Create tag**: \"Create a new tag called 'Finance'\"\n- **Delete tag**: \"Delete the tag with ID 5\"\n- **Tag an object**: \"Add the tag 'Finance' to dashboard 3\"\n- **Remove tag**: \"Remove the tag 'Finance' from chart 7\"\n\n## Available MCP Tools\n\nThis plugin offers the following MCP tools that Claude can use:\n\n### Authentication\n- `superset_auth_check_token_validity` - Check if the current access token is valid\n- `superset_auth_refresh_token` - Refresh the access token\n- `superset_auth_authenticate_user` - Authenticate with Superset\n\n### Dashboards\n- `superset_dashboard_list` - List all dashboards\n- `superset_dashboard_get_by_id` - Get a specific dashboard\n- `superset_dashboard_create` - Create a new dashboard\n- `superset_dashboard_update` - Update an existing dashboard\n- `superset_dashboard_delete` - Delete a dashboard\n\n### Charts\n- `superset_chart_list` - List all charts\n- `superset_chart_get_by_id` - Get a specific chart\n- `superset_chart_create` - Create a new chart\n- `superset_chart_update` - Update an existing chart\n- `superset_chart_delete` - Delete a chart\n\n### Databases\n- `superset_database_list` - List all databases\n- `superset_database_get_by_id` - Get a specific database\n- `superset_database_create` - Create a new database connection\n- `superset_database_get_tables` - List tables in a database\n- `superset_database_schemas` - Get schemas for a database\n- `superset_database_test_connection` - Test a database connection\n- `superset_database_update` - Update an existing database connection\n- `superset_database_delete` - Delete a database connection\n- `superset_database_get_catalogs` - Get catalogs for a database\n- `superset_database_get_connection` - Get database connection information\n- `superset_database_get_function_names` - Get function names supported by a database\n- `superset_database_get_related_objects` - Get charts and dashboards associated with a database\n- `superset_database_validate_sql` - Validate arbitrary SQL against a database\n- `superset_database_validate_parameters` - Validate database connection parameters\n\n### Datasets\n- `superset_dataset_list` - List all datasets\n- `superset_dataset_get_by_id` - Get a specific dataset\n- `superset_dataset_create` - Create a new dataset\n\n### SQL Lab\n- `superset_sqllab_execute_query` - Execute a SQL query\n- `superset_sqllab_get_saved_queries` - List saved SQL queries\n- `superset_sqllab_format_sql` - Format a SQL query\n- `superset_sqllab_get_results` - Get query results\n- `superset_sqllab_estimate_query_cost` - Estimate query cost\n- `superset_sqllab_export_query_results` - Export query results to CSV\n- `superset_sqllab_get_bootstrap_data` - Get SQL Lab bootstrap data\n\n### Queries\n- `superset_query_list` - List all queries\n- `superset_query_get_by_id` - Get a specific query\n- `superset_query_stop` - Stop a running query\n\n### Saved Queries\n- `superset_saved_query_get_by_id` - Get a specific saved query\n- `superset_saved_query_create` - Create a new saved query\n\n### User Information\n- `superset_user_get_current` - Get current user info\n- `superset_user_get_roles` - Get user roles\n\n### Activity\n- `superset_activity_get_recent` - Get recent activity data\n\n### System\n- `superset_menu_get` - Get menu data\n- `superset_config_get_base_url` - Get the base URL of the Superset instance\n\n### Tags\n- `superset_tag_list` - List all tags\n- `superset_tag_create` - Create a new tag\n- `superset_tag_get_by_id` - Get a specific tag\n- `superset_tag_objects` - Get objects associated with tags\n- `superset_tag_delete` - Delete a tag\n- `superset_tag_object_add` - Add a tag to an object\n- `superset_tag_object_remove` - Remove a tag from an object\n\n### Exploration Tools\n- `superset_explore_form_data_create` - Create form data for chart exploration\n- `superset_explore_form_data_get` - Get form data for chart exploration\n- `superset_explore_permalink_create` - Create a permalink for chart exploration\n- `superset_explore_permalink_get` - Get a permalink for chart exploration\n\n### Advanced Data Types\n- `superset_advanced_data_type_convert` - Convert a value to an advanced data type\n- `superset_advanced_data_type_list` - List available advanced data types\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| SUPERSET_BASE_URL | URL of your Superset instance | http://localhost:8088 |\n| SUPERSET_USERNAME | Username for Superset | None |\n| SUPERSET_PASSWORD | Password for Superset | None |\n\n## Troubleshooting\n\n- If you encounter authentication issues, verify your credentials in the `.env` file\n- Make sure Superset is running and accessible at the URL specified in your `.env` file\n- Check that you're using a compatible version of Superset (tested with version 4.1.1)\n- Ensure the port used by the MCP server is not being used by another application\n\n## Security Notes\n\n- Your Superset credentials are stored only in your local `.env` file\n- The access token is stored in `.superset_token` file in the project directory\n- All authentication happens directly between the MCP server and your Superset instance\n- No credentials are transmitted to Claude or any third parties\n- For production use, consider using more secure authentication methods\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenops-cloud%2Fsuperset-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenops-cloud%2Fsuperset-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenops-cloud%2Fsuperset-mcp/lists"}