Skip to main content
Glama
MTDevKit

MTDevKit

MTDevKit

An MCP (Model Context Protocol) server that scaffolds Flutter projects from a custom clean-architecture Bitbucket template. Any MCP-compatible AI agent (Claude Desktop, Claude Code, Cursor, etc.) can call it as a tool.

What it does

Tools

Tool

Description

create_flutter_project

Full 11-step project setup (clone template → git init → deps → l10n → flavorizr → config → Android)

list_flutter_projects

Scan a directory for Flutter projects

get_project_info

Read pubspec, config, git status of an existing project

Slash commands (prompts)

These show up when you type / in Cursor or other MCP clients:

Command

Description

/create-flutter-project

Scaffold a new Flutter project from the MT template

/list-flutter-projects

List all Flutter projects in a directory

/project-info

Get details about an existing Flutter project

create_flutter_project steps

  1. Install/update app_starter_plus

  2. Clone template & rename project

  3. Initialise Git (+ hooks if present)

  4. Install Flutter dependencies

  5. Generate localisations

  6. Update flavorizr.yaml with project name & org

  7. Commit all files before flavorizr

  8. Generate flavors (flavorizr)

  9. Revert main.dart & app.dart (overwritten by flavorizr)

  10. Create config files (dev / uat / prod)

  11. Configure Android build (desugaring, HMS, ProGuard)

create_flutter_project parameters

Parameter

Required

Description

name

Yes

Dart package name (e.g. my_super_app)

org

Yes

Reverse-domain org (e.g. mu.mt)

template

Template repo URL (defaults to Bitbucket template)

dir

Parent directory (defaults to cwd)

dry_run

Preview without executing

Related MCP server: Fables MCP Server

Prerequisites

  • Node.js >= 18

  • git

  • Flutter (via fvm or direct — fvm is auto-detected)

  • SSH key or credentials configured for your Bitbucket template repo

Install

Option 1: via npm (GitHub Packages)

npx -y @stephangopaul/mtdevkit --registry=https://npm.pkg.github.com

Option 2: from source

git clone https://github.com/stephangopaul/MTDevKit.git
cd MTDevKit
npm install
npm run build

Usage with Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "MTDevKit": {
      "command": "npx",
      "args": [
        "-y",
        "@stephangopaul/mtdevkit",
        "--registry=https://npm.pkg.github.com"
      ]
    }
  }
}

Or if running from source:

{
  "mcpServers": {
    "MTDevKit": {
      "command": "node",
      "args": ["/path/to/MTDevKit/dist/index.js"]
    }
  }
}

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "MTDevKit": {
      "command": "npx",
      "args": [
        "-y",
        "@stephangopaul/mtdevkit",
        "--registry=https://npm.pkg.github.com"
      ],
      "env": {
        "PATH": "/usr/local/bin:/usr/bin:/bin:/your/flutter/path"
      }
    }
  }
}

Tip: Make sure PATH in env includes the directories where fvm, git, and dart live.

Usage with Claude Code

claude mcp add MTDevKit -- npx -y @stephangopaul/mtdevkit --registry=https://npm.pkg.github.com

Example interaction

You: Create a new Flutter project called logistics_app for org mu.mt

Agent calls create_flutter_project with { name: "logistics_app", org: "mu.mt" } and returns the full setup log + project path.

Dry run

Pass dry_run: true to preview every command without executing anything — useful for confirming the plan before committing.

Customisation

  • Template URL — change DEFAULT_TEMPLATE in src/index.ts or pass it per-call

  • Config file shape — edit the configJson() helper to match your team's schema

  • Extra steps — add more steps by following the existing pattern in the tool handler

Available Tools

3 tools
create_flutter_projectA

Scaffold a new Flutter project from the custom clean-architecture template.

Runs the full 11-step setup:

  1. Install/update app_starter_plus

  2. Clone template & rename project

  3. Initialise Git (+ hooks if present)

  4. Install Flutter dependencies

  5. Generate localisations

  6. Update flavorizr.yaml with project name & org

  7. Commit all files before flavorizr

  8. Generate flavors (flavorizr)

  9. Revert main.dart & app.dart (overwritten by flavorizr)

  10. Create config files (dev / uat / prod)

  11. Configure Android build (desugaring, HMS, ProGuard)

Automatically detects fvm; falls back to plain flutter/dart if fvm is not installed. Returns the absolute path to the ready-to-develop project.

NOTE: This tool does NOT ask for confirmation — it runs immediately. Use dry_run=true first if you want to preview the plan before executing.

Inputs: org (required), name (required), dir, dry_run, +1 more.

get_project_infoB

Get details about an existing Flutter project (pubspec, flavors, config files, etc.).

Inputs: path (required).

list_flutter_projectsB

List Flutter projects in a given directory (looks for pubspec.yaml).

Inputs: dir.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: create a new project, list existing projects, and get project details. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case: create_flutter_project, list_flutter_projects, get_project_info. Predictable and clear.

    Tool Count5/5

    Three tools is an appropriate scope for a server focused on Flutter project scaffolding and inspection. Each tool earns its place without unnecessary bloat.

    Completeness4/5

    The tools cover core creation and read operations (list, info). Missing update or delete tools, but this is reasonable for a scaffolding-focused server; the create tool handles extensive setup.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides AI agents with tools to build, deploy, and manage Flutter applications, including APK/AAB generation, keystore management, and CI/CD integration.
      6 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A unified MCP server for scaffolding project structures across multiple frameworks including Spring Boot, React, Vue, Next.js, FastAPI, Django, Flask, Express, and more.
      2
      17 npm
      1
      MIT