mcp-agent-workflows
Use and maintain Vizro-MCP FastMCP server workflows for dashboard creation, validation, schemas, and PyCafe sharing.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 11
- Forks
- 3
01 前言 Front Matter
- name
- mcp-agent-workflows
- license
- Apache 2.0
- metadata
- { "disco-role": "operating" }
- description
- Use and maintain Vizro-MCP FastMCP server workflows for dashboard creation, validation, schemas, and PyCafe sharing.
- disable-model-invocation
- true
03 SKILL.md 正文
MCP Agent Workflows
Use this sub-skill when the task involves vizro-mcp, MCP server setup, agent-assisted dashboard generation, dashboard validation, schema extraction, PyCafe links, or repository changes under vizro-mcp/.
Route elsewhere when the task is mainly about:
- Hand-writing a dashboard without MCP:
../core-dashboard-build/SKILL.md. - Chart semantics inside a generated dashboard:
../charts-and-figures/SKILL.md. - Deprecated
vizro-ai:../legacy-ai-chart-agent/SKILL.md.
Package facts
- Import package:
vizro_mcp. - Main evidence file:
vizro-mcp/src/vizro_mcp/server.py. - The installed
vizro_mcp.serverexposesmcp,create_dashboard,validate_dashboard_config, schema/result models, and PyCafe helper functions in this snapshot. vizro-mcpdepends onmcp,httpx,click,pandas[html,parquet,excel],pydantic-settings, andvizro.
Safe first moves
For a user asking to use MCP with Vizro:
-
Explain that Vizro-MCP is the maintained agent-assistance route in this monorepo.
-
Check installed package importability before launching a server:
python - <<'PY' import vizro_mcp.server as s print(hasattr(s, 'mcp'), hasattr(s, 'create_dashboard'), hasattr(s, 'validate_dashboard_config')) PY -
Inspect
vizro-mcp/README.mdfor current server/CLI setup expected by the repository. -
Use validation helpers/schema output before generating or sharing external artifacts.
Dashboard generation/validation principles
- Treat generated dashboard code/config as untrusted until validated by Vizro models and, when feasible, built with
Vizro().build(). - Validate data paths and external URLs before embedding them in dashboards.
- Avoid writing files outside a user-approved output directory.
- Prefer deterministic local validation over agent/model calls when debugging generated code.
- If PyCafe sharing is requested, confirm whether network upload/link creation is allowed.
Schema work
When the task asks for schema/model JSON or LLM-facing dashboard instructions:
- Use
vizro_mcp.serverschema helpers and schema models as the source of truth. - Cross-check with
vizro-coremodel fields usingscripts/inspect_vizro_schema.pywhen changes involve core model definitions. - Keep schema output free of local absolute paths and secrets.
Repository edits
For changes under vizro-mcp/:
cd vizro-mcp
hatch run lint
hatch run test-unit tests/unit/vizro_mcp/test_server.py
If Hatch is unavailable, use the prepared installed-package environment and run focused pytest from vizro-mcp/, but preserve the package working directory.
Common failures
validate_dashboard_configerrors usually mean the generated dashboard does not match currentvizro.modelsschemas. Inspect the model fields and fix the config, not the validator.- Missing Excel/parquet/html dependencies: install/verify
pandas[html,parquet,excel]extras. - MCP server launch issues: separate import errors from transport/server configuration errors.
- PyCafe URL issues: check network permission and the helper in
tools/pycafe/create_pycafe_links_comments.py.
Evidence anchors
vizro-mcp/README.mdvizro-mcp/src/vizro_mcp/server.pyvizro-mcp/src/vizro_mcp/_schemas/schemas.pyvizro-mcp/tests/unit/vizro_mcp/test_server.pytools/pycafe/create_pycafe_links_comments.py
04 同仓库更多 Skills
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
obsidian-clipper-template-creator
Guide for creating templates for the Obsidian Web Clipper. Use when you want to create a new clipping template, understand available variables, or format clipped content.
python-api
Programmatic Object-Detection-Metrics API guidance for BoundingBox, BoundingBoxes, Evaluator, enums, coordinate conversion, AP/mAP semantics, and source-style import diagnostics.
file-evaluation
Folder-based PASCAL VOC AP/mAP evaluation from ground-truth and detection text files.
object-detection-metrics
Guides legacy Object-Detection-Metrics PASCAL VOC AP/mAP evaluation from detection text folders and direct Python API classes.
nx-workspace-patterns
Configure and optimize Nx monorepo workspaces. Use when setting up Nx, configuring project boundaries, optimizing build caching, or implementing affected commands.