Python MCP Hub
Provides Flutter-focused setup and delivery support, including profile selection (imespro, external-structured, external-standard), setup/doctor checks, company foundation package cloning, and Flutter-specific agent skills and validators.
Adds a Frappe UI stack pack with clean architecture rules and Frappe UI catalog guidance, syncing Frappe-specific skills and rules into supported workspaces.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Python MCP Hubvalidate my Flutter architecture design for the imespro profile"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Coder Nexus
Agent roles, skills and MCP tools that help an AI coding agent deliver software the way a team does: requirements → design → plan → code → review → verification.
Coder Nexus has three parts:
VS Code / Antigravity extension: copies agent roles, skills and rules into your project and gives you one-click commands to manage them.
coder-nexusCLI (Python Hub): the MCP server your agent talks to, plus terminal commands for Huly task intake, two-layer Figma extraction (tokens.json+<node>.spec.json+ per-screen.png/.jpg), and environment checks.skill-factoryCLI (new in 3.0): generators that write skills tailored to your workspace (architecture, clean code, tests, review, security, QA…). Installed together withcoder-nexus.
Installing it does not start anything on its own. Your host agent (for example Antigravity) reads the installed roles and skills and uses them when you ask it to work.
How it works
Coder Nexus organizes 7 specialized agent roles into 2 departments (dev-team, bug-squad) plus 2 read-only companion workflows (debug-investigation, feature-testing):
Your request / task ticket
│
├──► dev-team (Feature Delivery) ──► Spec Writer (Huly + Figma Intake: S-NN, W-NN) ──► [Gate 1 Approval]
│ │ (Zero-Re-Ask Handoff)
│ ▼
│ Planning [Gate 2 & 3] ──► Code Writer ──► Code Reviewer ──► Test Runner ──► Docs Writer (once after ACCEPTED)
│
└──► bug-squad (4-Gate Bug Resolution) ──► Bug Fixer (Reproduce ──► Root Cause & Impact ──► [S1-S4 & L1/L2/L3 Confirmation])
├── L1: Bug Fixer ──► Test Runner
├── L2: Bug Fixer ──► Code Reviewer ──► Test Runner
└── L3: Escalation Report ──► dev-team (Zero-Re-Ask Handoff)Concept | What it means |
2 Departments & 7 Roles |
|
Approval gates | You approve requirements, screens ( |
Zero-Re-Ask Handoffs | When |
Skills & Always-On rules | Constitutional guardrails in |
Stack packs & profiles | Rules and skills for a specific stack (Flutter, Backend). Profile-specific guidance ( |
Workspace skills | Skills generated by the Skill Factory into |
MCP tools | Task intake, architecture guidance, UX patterns, and validators the agent can call. |
Work & debug items | Feature artifacts live under |
Related MCP server: devops-mcp-server
Install
1. Install the extension
In VS Code / Antigravity open Extensions (Cmd+Shift+X / Ctrl+Shift+X), search Coder Nexus and click Install.
Or download a .vsix from Releases and use Extensions → … → Install from VSIX....
2. Install the CLI
Click Coder Nexus in the status bar → Install / Update CLI. It installs uv if needed, then the CLI matching the extension version.
Manual install:
curl -LsSf https://astral.sh/uv/install.sh | shuv tool install --force git+https://github.com/pzakhim/coder-nexus.git@vX.Y.Zcoder-nexus --helpOn Windows, install uv with powershell -c "irm https://astral.sh/uv/install.ps1 | iex". Replace X.Y.Z with your extension version. Run Install / Update CLI again after each extension update.
3. Add agents to your project
Open your project. If the extension detects a supported stack it offers Sync Now. Otherwise open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run Coder Nexus: Sync Stack to Workspace (Auto-Detect), then pick your stack.
The sync writes:
Path | Content |
| The 7 agent roles, combined with the rules of the selected pack |
| Always-On constitutional guardrails for the installed pack ( |
| Shared skills, stack skills (with active profile references injected), and |
| Which pack owns which folders (edit it if detection guessed wrong) |
Re-run the sync after installing or updating the CLI so the MCP config points to it.
4. Check your setup
coder-nexus doctorUsing it
Once synced, talk to your agent in natural language or name a workflow directly:
Workflow / Skill | When to use | Example prompt |
| End-to-end feature delivery: Huly + Figma intake ( | "Implement task ABC-12" or "Build the order screen from this Figma link" |
| Reproduce a bug, prove root cause & blast-radius impact, confirm severity ( | "Fix bug: the order list crashes when empty" or "Sửa lỗi task ABC-45" |
| Read-only investigation or runtime flow tracing with temporary | "Debug: why does the order list show yesterday's data?" or "Trace luồng từ màn B sang C" |
| Read-only scenario testing by | "Test function A going from page B to C to D" |
Fixing a bug (bug-squad)
Report it, for example "Fix bug: the order list crashes when empty". The bug-squad skill enforces a strict 4-Gate Anti-Rush Sequence in .superpowers/debug/<bug-slug>/ so the agent never jumps straight to editing code:
Reproduce first:
Bug Fixerreproduces the failure via an uncommitted failing test or live runtime run (NOT_REPRODUCEDstops immediately).Root cause & call-graph impact: Pinpoints the exact
file:linecause using git forensics / runtime traces and maps affected callers (gitnexus+rg).Classify & confirm: Proposes severity (
S1–S4) and fix level for your confirmation before touching production code:L1 (Quick patch): Fixed by
Bug Fixer(starting with a failing regression test) and verified byTest Runnerwithout code review.L2 (Local fix): Follows
fixing-plan.md, goes throughCode Reviewer, and is verified byTest Runner.L3 (Escalate): Contract, schema, shared-code, or business-rule changes write
escalation-report.md(with zero code edits) and hand off todev-team.
Debugging without fixing (debug-investigation)
Ask, for example "Debug: why does the order list show yesterday's data?" or "Trace what happens from page B to C". The debug-investigation skill has Bug Fixer reproduce the bug or run the scenario, add tagged temporary logs ([DBG-<slug>]) when needed, and write diagnosis.md in .superpowers/debug/<slug>/. Every temporary log is removed and verified clean before it reports DIAGNOSED; no code change is kept. If you then want the bug fixed, it hands diagnosis.md directly to bug-squad without repeating the investigation.
Testing a scenario (feature-testing)
Give a scenario in your own words or as a file, for example "Test function A going from page B to C to D". The feature-testing skill has Test Runner turn it into cases, use default checks where you gave no expected result, run them on the app or API, and report PASS/FAIL per case with evidence in .superpowers/test-runs/<slug>/. It never writes tests or fixes code; any FAIL case can be handed directly to bug-squad on your confirmation.
Task intake (optional)
Connect a task tracker so agents can read tickets. Credentials go into the project's local .env. Make sure .env is in .gitignore.
Command | What it does |
| Guided setup: workspace URL, then login |
| Check that the configuration is complete (read-only) |
| Start setup again (e.g. expired session) |
| List your open tasks ( |
| Show a task with its acceptance criteria |
| Also save attachments and linked designs under |
You can also just ask the agent to "set up Huly".
Figma two-layer extraction (optional, read-only)
Add FIGMA_TOKEN=… to .env. Linked frames are downloaded with task-detail --download, or fetch one directly:
coder-nexus figma fetch "https://www.figma.com/design/<key>/<name>?node-id=<id>"Each fetch writes per-screen renders (<stem>-SNN.png or --format jpg), a file-level W3C DTCG tokens.json (extracted from Figma styles, bound variables, and component sets), a Framelink-inspired normalized <stem>.spec.json (screens, workflows_inferred, and normalized node tree referencing tokens.json), and the raw <stem>.json ground truth.
Stack setup
coder-nexus setup flutter --checkcoder-nexus setup flutter --profile external-standardProfiles tell the agent where a Flutter project's shared building blocks come from:
Profile | Use when the project… |
| has no shared component library; use standard framework widgets |
| has its own design system or shared components ( |
| resolves the internal sibling packages ( |
When a profile is selected (saved in .superpowers/setup.json), syncing or running setup flutter automatically injects that profile's reference guides into the installed Flutter skills under .agents/plugins/coder-nexus/skills/. coder-nexus setup flutter also runs step [4/6] Developer tools, the same as setup tools --pack flutter below. Missing tools never make the setup gate fail.
Developer tools
The skills check code with real tools (linters, type checkers, test helpers) instead of relying on the agent's reading alone. Set them up per pack:
Command | What it does |
| Flutter project setup and the Flutter tools |
| Only the Flutter tools |
| Only the backend tools |
| Only the named tools, optional ones included (e.g. |
| Read-only: what is installed and what is missing |
It lists the planned changes and asks once before applying them (--yes skips the question). Dev dependencies go through the stack's own package manager, missing lint or type config is added without rewriting yours, and tools it cannot install get an install hint. Results are recorded in .agents/coder-nexus.setup.json. Syncing the plugin never runs it and never edits your project files.
Kind | Backend | Flutter |
Dev dependencies (default) |
|
|
Dev dependencies (optional, with |
|
|
Config (added only when missing) |
| lint include and rules in |
Installed for your user |
|
|
Run through |
| — |
Checked only (install hint) |
|
|
Skill Factory (new in 3.0)
Fixed packs give every project the same rules. The Skill Factory instead gives you generators: each one studies your workspace, asks you to confirm the key decisions, and writes a skill that fits your code, stack and conventions. The generated skill lives in .agents/skills/ and is yours to edit. When it covers the same topic as a pack skill, the Code Writer and Code Reviewer follow your skill.
skill-factory listskill-factory get -p coderThen ask your agent to run a generator, e.g. /create-clean-code-skill in Claude Code. It writes the real skill (for example .agents/skills/clean-code/) and trial-runs it on your code.
Package | Generators ( |
| clean-architecture · incremental-implementation · clean-code · unit-testing · code-simplification · bug-hunt · root-cause-debugging · secure-coding-standards · database-migrations · git-workflow · api-contract-design |
| code-review · bug-hunt · clean-architecture · clean-code · unit-testing · secure-coding-standards · database-migrations · security-review · git-workflow · api-contract-design |
| secure-coding-standards · security-review |
| quality-planning · quality-environment · quality-acceptance · quality-reporting · visual-quality · domain-knowledge |
| domain-knowledge · requirements-specification · change-impact-analysis · implementation-planning · api-contract-design |
Command | What it does |
| List generators with version, package and scope |
| Copy one or more generators ( |
| Copy a whole package |
| Copy everything |
get writes the generator to .agents/skills/create-*-skill/, a shared core to .agents/skill-factory-core/, and a link under .claude/skills/ so Claude Code can run it. Use --force to refresh existing copies and --workspace PATH to target another folder. Copies you already have are never overwritten without --force; compare them with a newer generator and keep what you want. Details: Skill Factory guide.
Inspect the MCP tools
npx @modelcontextprotocol/inspector coder-nexus serveWorking on Coder Nexus
Requirements: Python 3.12+, uv, Node.js (for packaging).
uv syncuv run pytest -quv run coder-nexus install-plugin --pack flutter --workspace /path/to/projectnpx @vscode/vsce package --no-dependencies --readme-path README.extension.mdPath | Content |
| CLI and MCP server |
|
|
| Agent roles, skills and stack packs (built by |
| VS Code extension |
| Detailed guides |
| Page shown on the extension marketplace |
Releases are published by pushing a vX.Y.Z tag.
Ground rules for agents
Agents cannot approve their own gates.
Task tracker and Figma access is read-only.
A result is reported as
PASSonly with evidence. Otherwise it staysBLOCKED,NOT_RUNorUNVERIFIED.
More
License: MIT
Available Tools
8 toolsget_project_structureA
Retrieve Clean Architecture blueprint and guidelines for Flutter project root or feature module.
Strictly READ-ONLY: Never generates code or touches files in the workspace.
Zero Mock Data: Returns verified blueprints with traceable source references.
Args:
scope: Either 'root' (top-level layout & boot sequence) or 'module' (feature module).
feature_name: Name of the feature module in lower_snake_case (required if scope='module').
Returns:
A dictionary containing blueprint tree, DI order, and source citations.
| Name | Required | Description | Default |
|---|---|---|---|
| scope | Yes | ||
| feature_name | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
get_ux_error_patternsA
Retrieve UX design patterns, UI behaviors, and BLoC state transitions for error/edge scenarios.
Args:
scenario: Error or edge scenario identifier (e.g., 'auth_failure', 'network_timeout', 'form_validation', 'empty_state').
Returns:
Dictionary containing UI behavior guidance, BLoC state pattern, and anti-patterns.
| Name | Required | Description | Default |
|---|---|---|---|
| scenario | Yes |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
huly_get_my_tasksA
Open Huly tasks assigned to the logged-in user (status category not Done/Canceled).
Strictly READ-ONLY: Never modifies tasks on Huly.
Zero Mock Data: Fails fast if credentials are not configured or network error occurs.
Args:
workspace_path: Client workspace containing the .env with Huly credentials.
Defaults to current working directory if empty.
include_all: List open tasks of the whole workspace instead of only the user's own.
Returns:
Task count and the open tasks with ID, title, status name, priority, assignee and due date.
| Name | Required | Description | Default |
|---|---|---|---|
| include_all | No | ||
| workspace_path | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
huly_get_task_detailA
Read the FULL context of one Huly issue the user names (READ-ONLY on Huly).
Returns: title, description text, status name + category, priority, assignee name, due date,
explicit acceptance criteria (with source), parent, direct sub-issues (status, assignee, AC),
comments (author, time, text) and `sources`: every PO document mention, image, attachment,
file link (e.g. a PDF linked in a comment) and external link the ticket points to, each with
a status: READ (document text included), DOWNLOADED (saved file path), AVAILABLE (call again
with download=true), UNREACHABLE (this account cannot open it: ask the user) or EXTERNAL.
Args:
task_id: The issue the user named: an ID ('APP-123'), a number ('123', only if unique),
a Huly _id, or a Huly issue link pasted from the browser.
workspace_path: Client workspace containing the .env with Huly credentials.
include_sub_issues: Also return direct child issues (one level) with their own criteria.
A parent issue is one feature: write one spec and use the children as
planning input. A child issue: scope the spec to it; parent is context only.
download: Save files, images, attachments and readable documents to
<workspace>/.superpowers/sources/<ISSUE-ID>/ so they can be opened and read
(PDF, images). Use it before writing requirements. A linked Figma frame is
saved to figma/ (PNG, node JSON, summary) as a `figma` source: READ,
NOT_PROVIDED (no FIGMA_TOKEN in the .env) or UNREACHABLE (401/403/404).
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | ||
| download | No | ||
| workspace_path | No | ||
| include_sub_issues | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
validate_architecture_codeA
Validate Dart source code against enterprise Clean Architecture rules for a specific layer.
Strictly READ-ONLY: Performs static analysis on the provided code string without writing files.
Zero Mock Data: Fails fast on invalid inputs or malformed layers, returning structured violations.
Args:
dart_code: Full Dart source code to analyze.
layer: Architecture layer ('domain', 'data', 'presentation', 'core', 'module').
architecture_profile: Approved mode: imespro, external-structured, or external-standard.
Omitted values retain legacy iMESPro checks. External Client conventions need manual verification.
Returns:
Dictionary with status, valid flag, list of violations, checked rules, and unsupported checks.
| Name | Required | Description | Default |
|---|---|---|---|
| layer | Yes | ||
| dart_code | Yes | ||
| architecture_profile | No | imespro |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
validate_module_architectureA
Validate module boundaries using the approved architecture profile.
iMESPro also checks its layer, screen and DI conventions. External layout/DI needs Client inspection.
Strictly READ-ONLY: Performs static inspection of the module directory without writing files.
Zero Mock Data: Fails fast if module directory does not exist or has invalid structure.
Args:
module_path: Path to the feature module directory (e.g. lib/modules/<feature>).
feature_name: Name of the feature module (optional, inferred from path if omitted).
architecture_profile: Approved mode: imespro, external-structured, or external-standard.
Omitted values retain legacy iMESPro checks. External layout/DI checks remain UNVERIFIED.
Returns:
Dictionary containing validation status, gate_status (PASSED/FAILED), violations, and checked rules.
| Name | Required | Description | Default |
|---|---|---|---|
| module_path | No | ||
| feature_name | No | ||
| architecture_profile | No | imespro |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
validate_plan_slicesA
Validate a versioned implementation plan and its linked behavior phases, or a legacy plan/task pair.
Strictly READ-ONLY: Never modifies files in the workspace.
Zero Mock Data: Fails fast on invalid inputs or malformed schemas, returning structured violations.
Versioned plans map ACs to linked phases in one version directory. A scoped UI-only phase is valid.
Args:
plan_content: Raw text of implementation-plan.md or a legacy plan.
plan_path: Optional path to docs/features/<module>/<feature>/vN/implementation-plan.md.
task_content: Legacy task.md content; unused for versioned plans.
task_path: Legacy task.md path; unused for versioned plans.
feature_name: Name of the feature module (optional).
Returns:
Dictionary containing validation status, gate_status (PASSED/FAILED), violations, and checked rules.
| Name | Required | Description | Default |
|---|---|---|---|
| plan_path | No | ||
| task_path | No | ||
| feature_name | No | ||
| plan_content | No | ||
| task_content | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
validate_proposal_specA
Validate versioned requirements, codebase-notes, change impact, or design Markdown; legacy proposals remain readable.
Strictly READ-ONLY: Never modifies files in the workspace.
Zero Mock Data: Fails fast on invalid inputs or malformed schemas, returning structured violations.
Anti-Self-Approval: Detects and rejects unauthorized autonomous approvals (APPROVED_BY_SPEC).
Args:
proposal_content: Raw Markdown content of a requirements, codebase-notes, impact, design, or legacy proposal document.
proposal_path: Optional path in docs/features/<module>/<feature>/vN/ or docs/work-items/<slug>/vN/ (legacy paths also supported).
feature_name: Name of the feature module (optional).
Returns:
Dictionary containing structural validation status, violations, and checked rules; never user approval.
| Name | Required | Description | Default |
|---|---|---|---|
| feature_name | No | ||
| proposal_path | No | ||
| proposal_content | No |
Output Schema
| Name | Required | Description |
|---|---|---|
No output parameters | ||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
8 tool updates
v3.3.1- First observed
get_project_structure - First observed
get_ux_error_patterns - First observed
huly_get_my_tasks - First observed
huly_get_task_detail - First observed
validate_architecture_code - First observed
validate_module_architecture - First observed
validate_plan_slices - First observed
validate_proposal_spec
TDQS
Scored across 8 tools
Most tools target distinct artifacts: UX patterns, two Huly read operations, a project blueprint, and four validators keyed to different inputs (Dart code string, proposal Markdown, plan Markdown, module directory). The only real overlap is validate_architecture_code vs validate_module_architecture, which both enforce Clean Architecture rules but on different inputs (source string vs directory path) — the descriptions do disambiguate this, though an agent could still hesitate.
Nearly everything follows a clean verb_noun snake_case pattern with a clear family of validate_* tools and get_* retrievals. The two huly_* tools break the pattern by adding a domain prefix while the other six do not, a minor deviation that is still readable and arguably intentional namespacing.
Eight tools is a well-scoped count with each validator earning its place against a distinct workflow artifact. It is slightly lean for something branded a 'hub', since the surface spans two unrelated domains (Huly task retrieval and Flutter architecture validation) with no bridging tools.
The read-only validation workflow is reasonably covered end-to-end: blueprint retrieval, code-layer checks, module-boundary checks, spec validation, and plan-slice gating. However the surface has no write or creation path at all (no authoring specs, no creating or updating tasks), UX guidance is limited to error/edge scenarios only, and there is no tool to discover or list existing docs/tasks before validating them.
Maintenance
Related MCP Connectors
Agent-native catalogue of Baseframe Labs dev tools and MCP servers.
A read-only verified record of agent-operable GTM tools: search, fetch, compare, track changes.
Read-only catalog of app-building materials: fonts, APIs, MCP servers, libraries, templates, data.
71Read-only catalog of verified MCP servers and Agent Skills by dev task, with practical verdicts.
Related MCP Servers
- AlicenseAqualityCmaintenanceExposes the squad-dev workflow as deterministic MCP tools, enabling task classification, risk scoring, specialist reviewer selection, and advisory verdict consolidation for code changes.2746 npm4Apache 2.0
- FlicenseNot gradedqualityDmaintenanceExposes DevOps/SRE operations like Kubernetes pod status, Prometheus metrics queries, and deploy history as tools for MCP-compatible clients.-
- AlicenseAqualityDmaintenanceRead-only MCP tools for coding agents to audit deployment targets, detect fabricated code, review backlog, database schema, analytics, ML models, architecture docs, and decision lenses.1114 npmMIT
- FlicenseNot gradedqualityBmaintenanceExposes read-only MCP tools for discovering Frasma's profile and knowledge base, accessing the diagnostic framework, and preparing validated process briefs and diagnostic summaries with handoff URLs. It enables agents to gather operational context and generate quote-ready process assessments without sending emails.-