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

Slash commands (prompts)

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

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

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