lmiranda
9d5615409c
Critical fixes: - Fix projman version mismatch (3.1.0 -> 3.2.0 in plugin.json) - Update CLAUDE.md version to 4.1.0 Stale documentation updates: - Add viz-platform to README.md (plugins, MCP servers, verification table) - Add viz-platform to COMMANDS-CHEATSHEET.md (8 commands, hooks, MCP table) - Add viz-platform and data-platform to CANONICAL-PATHS.md - Add viz-platform and data-platform to CONFIGURATION.md - Fix CHANGELOG.md tool counts (Layout 5, Theme 6, Page 5) - Add data-platform to CLAUDE.md repository structure Missing documentation: - Create mcp-servers/viz-platform/README.md (21 tools documented) - Add viz-platform SessionStart hook to COMMANDS-CHEATSHEET.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
116 lines
3.5 KiB
Markdown
116 lines
3.5 KiB
Markdown
# viz-platform MCP Server
|
|
|
|
Model Context Protocol (MCP) server for Dash Mantine Components validation and visualization tools.
|
|
|
|
## Overview
|
|
|
|
This MCP server provides 21 tools for:
|
|
- **DMC Validation**: Version-locked component registry prevents Claude from hallucinating invalid props
|
|
- **Chart Creation**: Plotly-based visualization with theme integration
|
|
- **Layout Composition**: Dashboard layouts with responsive grids
|
|
- **Theme Management**: Design token-based theming system
|
|
- **Page Structure**: Multi-page Dash app generation
|
|
|
|
## Tools
|
|
|
|
### DMC Tools (3)
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `list_components` | List available DMC components by category |
|
|
| `get_component_props` | Get valid props, types, and defaults for a component |
|
|
| `validate_component` | Validate component definition before use |
|
|
|
|
### Chart Tools (2)
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `chart_create` | Create Plotly chart (line, bar, scatter, pie, histogram, area, heatmap) |
|
|
| `chart_configure_interaction` | Configure chart interactions (zoom, pan, hover) |
|
|
|
|
### Layout Tools (5)
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `layout_create` | Create dashboard layout structure |
|
|
| `layout_add_filter` | Add filter components to layout |
|
|
| `layout_set_grid` | Configure responsive grid settings |
|
|
| `layout_get` | Retrieve layout configuration |
|
|
| `layout_add_section` | Add sections to layout |
|
|
|
|
### Theme Tools (6)
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `theme_create` | Create new theme with design tokens |
|
|
| `theme_extend` | Extend existing theme with overrides |
|
|
| `theme_validate` | Validate theme completeness |
|
|
| `theme_export_css` | Export theme as CSS custom properties |
|
|
| `theme_list` | List available themes |
|
|
| `theme_activate` | Set active theme for visualizations |
|
|
|
|
### Page Tools (5)
|
|
|
|
| Tool | Description |
|
|
|------|-------------|
|
|
| `page_create` | Create new page structure |
|
|
| `page_add_navbar` | Add navigation bar to page |
|
|
| `page_set_auth` | Configure page authentication |
|
|
| `page_list` | List available pages |
|
|
| `page_get_app_config` | Get full app configuration |
|
|
|
|
## Configuration
|
|
|
|
### Environment Variables
|
|
|
|
| Variable | Required | Description |
|
|
|----------|----------|-------------|
|
|
| `DMC_VERSION` | No | Dash Mantine Components version (auto-detected if installed) |
|
|
| `VIZ_DEFAULT_THEME` | No | Default theme name |
|
|
| `CLAUDE_PROJECT_DIR` | No | Project directory for theme storage |
|
|
|
|
### Theme Storage
|
|
|
|
Themes can be stored at two levels:
|
|
- **User-level**: `~/.config/claude/themes/`
|
|
- **Project-level**: `{project}/.viz-platform/themes/`
|
|
|
|
Project-level themes take precedence.
|
|
|
|
## Component Registry
|
|
|
|
The server uses a static JSON registry for DMC component validation:
|
|
- Pre-generated from DMC source code
|
|
- Version-tagged (e.g., `dmc_2_5.json`)
|
|
- Prevents hallucination of non-existent props
|
|
- Fast, deterministic validation
|
|
|
|
Registry files are stored in `registry/` directory.
|
|
|
|
## Tests
|
|
|
|
94 tests with coverage:
|
|
- `test_config.py`: 82% coverage
|
|
- `test_component_registry.py`: 92% coverage
|
|
- `test_dmc_tools.py`: 88% coverage
|
|
- `test_chart_tools.py`: 68% coverage
|
|
- `test_theme_tools.py`: 99% coverage
|
|
|
|
Run tests:
|
|
```bash
|
|
cd mcp-servers/viz-platform
|
|
source .venv/bin/activate
|
|
pytest tests/ -v
|
|
```
|
|
|
|
## Dependencies
|
|
|
|
- Python 3.10+
|
|
- FastMCP
|
|
- plotly
|
|
- dash-mantine-components (optional, for version detection)
|
|
|
|
## Usage
|
|
|
|
This MCP server is used by the `viz-platform` plugin. See [plugins/viz-platform/README.md](../../plugins/viz-platform/README.md) for usage instructions.
|