flutter-dev-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nick Clifford
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,239 @@
+# flutter-dev-mcp
+
+An MCP (Model Context Protocol) server that gives AI coding agents first-class Flutter development tools.
+
+## Why?
+
+Flutter CLI tools are designed for humans, not agents. `flutter test` dumps hundreds of lines of output that overwhelm context windows. `flutter run` requires interactive terminal access for hot reload. `flutter analyze` produces unstructured text. This MCP server wraps the Flutter CLI into structured, agent-friendly tools with sensible output limits.
+
+Key design decisions:
+- **Test results are two-phase**: `flutter_test` returns a compact summary of failures. `flutter_get_result` fetches full error details for specific tests. This prevents a single test run from blowing the context window.
+- **All outputs are capped at 24KB** to stay within typical tool response limits.
+- **`flutter run` is managed**: The server holds the process, exposes hot reload/restart/logs/kill as separate tools, so the agent doesn't need terminal access.
+- **Inputs are sanitized**: All commands use array-based process spawning (no shell). Project paths are normalized and validated. Package names and device IDs are checked for flag injection.
+
+## Tools at a glance
+
+| Tool | Parameters | Description |
+|------|-----------|-------------|
+| `flutter_test` | project_dir, [test_path], [test_name] | Run tests and return a compact summary of failures only. Use `flutter_get_result` to drill into specific failures. |
+| `flutter_get_result` | test_run_id, test_ids | Get full error details for specific test IDs from a previous `flutter_test` run. Output capped at 24KB. |
+| `flutter_run` | project_dir, [device], [is_debug], [dont_detach] | Start a Flutter app on `device` (e.g. `macos`, `chrome`, emulator ID) in debug or release mode. By default detaches after the app starts and returns a `run_id`. |
+| `flutter_hot_reload` | run_id | Hot reload a running app. |
+| `flutter_hot_restart` | run_id | Hot restart a running app. |
+| `flutter_kill` | run_id | Kill a running app. Graceful shutdown, force-kills after 5s. |
+| `flutter_logs` | run_id | Get logs from a running app. Returns the most recent output, capped at 24KB. |
+| `flutter_analyze` | project_dir | Run static analysis. Returns structured issues with severity, file, line, column, and rule name. |
+| `flutter_devices` | [wireless] | List available devices (simulators, emulators, physical). Skips wireless scan by default. |
+| `flutter_clean` | project_dir | Delete build artifacts. Useful when builds get into a bad state. |
+| `flutter_pub_get` | project_dir | Resolve and download dependencies. |
+| `flutter_pub_add` | project_dir, packages, [dev] | Add one or more packages. Supports `dev` dependencies. |
+| `flutter_gen_l10n` | project_dir | Generate localization files from ARB files. |
+| `flutter_build_runner` | project_dir, [delete_conflicting] | Run `build_runner` for code generation (freezed, json_serializable, drift, etc.). |
+
+Parameters in `[brackets]` are optional.
+
+## Install
+
+Requires Node.js 18+ and Flutter SDK on your PATH.
+
+```bash
+npm install -g flutter-dev-mcp
+```
+
+Or run directly with npx (recommended):
+
+```bash
+npx flutter-dev-mcp
+```
+
+## Configuration
+
+### Claude Code (CLI)
+
+Add to your MCP settings (`~/.claude.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "flutter-dev": {
+      "command": "npx",
+      "args": ["flutter-dev-mcp"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "flutter-dev": {
+      "command": "npx",
+      "args": ["flutter-dev-mcp"]
+    }
+  }
+}
+```
+
+### Codex / Other agents
+
+Any agent that supports MCP can use this server. Point it at the stdio transport:
+
+```bash
+npx flutter-dev-mcp
+```
+
+The server communicates over stdin/stdout using the MCP JSON-RPC protocol.
+
+## Tools
+
+### Testing
+
+#### `flutter_test`
+
+Run tests and get a summary of failures.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_dir` | string | yes | Path to the Flutter project |
+| `test_path` | string | no | Specific test file or directory |
+| `test_name` | string | no | Filter by test name (plain string match) |
+
+Returns a `test_run_id` and an array of failed tests with short error excerpts. Pass the `test_run_id` to `flutter_get_result` for full details.
+
+#### `flutter_get_result`
+
+Get full error output for specific test IDs from a previous run.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `test_run_id` | number | yes | From a previous `flutter_test` call |
+| `test_ids` | number[] | yes | Test IDs to get details for |
+
+Output is capped at 24KB total. If a single test exceeds that, its error is truncated. If multiple tests would exceed it, only tests that fit are returned.
+
+### App lifecycle
+
+#### `flutter_run`
+
+Start a Flutter app and get a `run_id` for subsequent commands.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `project_dir` | string | yes | | Path to the Flutter project |
+| `device` | string | no | `""` | Device ID (e.g. `chrome`, `macos`, emulator ID) |
+| `is_debug` | boolean | no | `true` | Debug mode (true) or release mode (false) |
+| `dont_detach` | boolean | no | `false` | Wait for app to exit instead of returning after start |
+
+#### `flutter_hot_reload`
+
+Trigger a hot reload on a running app.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `run_id` | number | yes | From a previous `flutter_run` call |
+
+#### `flutter_hot_restart`
+
+Trigger a hot restart on a running app.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `run_id` | number | yes | From a previous `flutter_run` call |
+
+#### `flutter_kill`
+
+Kill a running app. Sends `q` for graceful shutdown, force-kills after 5s.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `run_id` | number | yes | From a previous `flutter_run` call |
+
+#### `flutter_logs`
+
+Get logs from a running app. Returns the most recent output, capped at 24KB.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `run_id` | number | yes | From a previous `flutter_run` call |
+
+### Analysis
+
+#### `flutter_analyze`
+
+Run static analysis. Returns structured issues with severity, file location, and lint rule name.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_dir` | string | yes | Path to the Flutter project |
+
+#### `flutter_devices`
+
+List available devices.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `wireless` | boolean | no | `false` | Include wireless devices (slower) |
+
+### Dependencies & codegen
+
+#### `flutter_pub_get`
+
+Resolve and download dependencies.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_dir` | string | yes | Path to the Flutter project |
+
+#### `flutter_pub_add`
+
+Add packages to the project.
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `project_dir` | string | yes | | Path to the Flutter project |
+| `packages` | string[] | yes | | Package names (e.g. `["http", "provider"]`) |
+| `dev` | boolean | no | `false` | Add as dev dependency |
+
+#### `flutter_clean`
+
+Delete build artifacts. Useful when builds get into a bad state.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_dir` | string | yes | Path to the Flutter project |
+
+#### `flutter_gen_l10n`
+
+Generate localization files from ARB files.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_dir` | string | yes | Path to the Flutter project |
+
+#### `flutter_build_runner`
+
+Run `dart run build_runner build` for code generation (freezed, json_serializable, drift, etc.).
+
+| Parameter | Type | Required | Default | Description |
+|-----------|------|----------|---------|-------------|
+| `project_dir` | string | yes | | Path to the Flutter project |
+| `delete_conflicting` | boolean | no | `true` | Delete conflicting outputs before building |
+
+## Building from source
+
+```bash
+git clone <repo-url>
+cd flutter-dev-mcp
+npm install
+npm run build
+node dist/index.js
+```
+
+## License
+
+MIT

package/dist/flutter-analyze.d.ts

@@ -0,0 +1,16 @@
+interface AnalyzeIssue {
+    severity: "error" | "warning" | "info";
+    message: string;
+    file: string;
+    line: number;
+    column: number;
+    rule: string;
+}
+export interface AnalyzeResult {
+    issues: AnalyzeIssue[];
+    error_count: number;
+    warning_count: number;
+    info_count: number;
+}
+export declare function flutterAnalyze(projectDir: string): Promise<AnalyzeResult>;
+export {};

package/dist/flutter-analyze.js

@@ -0,0 +1,95 @@
+import { spawn } from "node:child_process";
+export async function flutterAnalyze(projectDir) {
+    await runPubGet(projectDir);
+    const output = await runAnalyze(projectDir);
+    return parseAnalyzeOutput(output);
+}
+// Pattern: "   info • message • file:line:col • rule_name"
+const issuePattern = /^\s*(error|warning|info)\s+•\s+(.+?)\s+•\s+(.+?):(\d+):(\d+)\s+•\s+(\S+)\s*$/;
+function parseAnalyzeOutput(output) {
+    const issues = [];
+    let errorCount = 0;
+    let warningCount = 0;
+    let infoCount = 0;
+    for (const line of output.split("\n")) {
+        const match = issuePattern.exec(line);
+        if (!match)
+            continue;
+        const severity = match[1];
+        issues.push({
+            severity,
+            message: match[2],
+            file: match[3],
+            line: parseInt(match[4], 10),
+            column: parseInt(match[5], 10),
+            rule: match[6],
+        });
+        if (severity === "error")
+            errorCount++;
+        else if (severity === "warning")
+            warningCount++;
+        else
+            infoCount++;
+    }
+    return {
+        issues,
+        error_count: errorCount,
+        warning_count: warningCount,
+        info_count: infoCount,
+    };
+}
+function runPubGet(projectDir) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn("flutter", ["pub", "get"], {
+            cwd: projectDir,
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+        let stderr = "";
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`flutter pub get failed with code ${code}: ${stderr}`));
+            }
+            else {
+                resolve();
+            }
+        });
+        proc.on("error", (err) => {
+            reject(new Error(`Failed to start flutter pub get: ${err.message}`));
+        });
+    });
+}
+function runAnalyze(projectDir) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn("flutter", ["analyze", "--no-pub"], {
+            cwd: projectDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            // flutter analyze exits non-zero when issues are found — that's expected
+            if (stdout.length > 0) {
+                resolve(stdout);
+            }
+            else if (code !== 0 && stderr.length > 0) {
+                reject(new Error(`flutter analyze failed: ${stderr}`));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+        proc.on("error", (err) => {
+            reject(new Error(`Failed to start flutter analyze: ${err.message}`));
+        });
+    });
+}
+//# sourceMappingURL=flutter-analyze.js.map

package/dist/flutter-analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter-analyze.js","sourceRoot":"","sources":["../src/flutter-analyze.ts"],"names":[],"mappings":"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"}

package/dist/flutter-commands.d.ts

@@ -0,0 +1,10 @@
+interface CommandResult {
+    success: boolean;
+    output: string;
+}
+export declare function flutterClean(projectDir: string): Promise<CommandResult>;
+export declare function flutterPubGet(projectDir: string): Promise<CommandResult>;
+export declare function flutterPubAdd(projectDir: string, packages: string[], dev: boolean): Promise<CommandResult>;
+export declare function flutterGenL10n(projectDir: string): Promise<CommandResult>;
+export declare function flutterBuildRunner(projectDir: string, deleteConflicting: boolean): Promise<CommandResult>;
+export {};

package/dist/flutter-commands.js

@@ -0,0 +1,53 @@
+import { spawn } from "node:child_process";
+function runCommand(command, projectDir, args) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, {
+            cwd: projectDir,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            const output = (stdout + stderr).trim();
+            resolve({
+                success: code === 0,
+                output: output || `Exited with code ${code}`,
+            });
+        });
+        proc.on("error", (err) => {
+            reject(new Error(`Failed to run ${command} ${args.join(" ")}: ${err.message}`));
+        });
+    });
+}
+function runFlutterCommand(projectDir, args) {
+    return runCommand("flutter", projectDir, args);
+}
+export async function flutterClean(projectDir) {
+    return runFlutterCommand(projectDir, ["clean"]);
+}
+export async function flutterPubGet(projectDir) {
+    return runFlutterCommand(projectDir, ["pub", "get"]);
+}
+export async function flutterPubAdd(projectDir, packages, dev) {
+    const args = ["pub", "add"];
+    if (dev)
+        args.push("--dev");
+    args.push(...packages);
+    return runFlutterCommand(projectDir, args);
+}
+export async function flutterGenL10n(projectDir) {
+    return runFlutterCommand(projectDir, ["gen-l10n"]);
+}
+export async function flutterBuildRunner(projectDir, deleteConflicting) {
+    const args = ["run", "build_runner", "build"];
+    if (deleteConflicting)
+        args.push("--delete-conflicting-outputs");
+    return runCommand("dart", projectDir, args);
+}
+//# sourceMappingURL=flutter-commands.js.map

package/dist/flutter-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter-commands.js","sourceRoot":"","sources":["../src/flutter-commands.ts"],"names":[],"mappings":"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"}

package/dist/flutter-devices.d.ts

@@ -0,0 +1,9 @@
+interface FlutterDevice {
+    name: string;
+    id: string;
+    targetPlatform: string;
+    emulator: boolean;
+    sdk: string;
+}
+export declare function flutterDevices(wireless: boolean): Promise<FlutterDevice[]>;
+export {};

package/dist/flutter-devices.js

@@ -0,0 +1,48 @@
+import { spawn } from "node:child_process";
+export async function flutterDevices(wireless) {
+    const output = await runDevices(wireless);
+    try {
+        const raw = JSON.parse(output);
+        return raw.map((d) => ({
+            name: d.name,
+            id: d.id,
+            targetPlatform: d.targetPlatform,
+            emulator: d.emulator,
+            sdk: d.sdk,
+        }));
+    }
+    catch {
+        throw new Error(`Failed to parse flutter devices output: ${output.substring(0, 500)}`);
+    }
+}
+function runDevices(wireless) {
+    return new Promise((resolve, reject) => {
+        const args = ["devices", "--machine"];
+        if (!wireless) {
+            args.push("--device-connection", "attached");
+        }
+        const proc = spawn("flutter", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        proc.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        proc.on("close", (code) => {
+            if (code !== 0) {
+                reject(new Error(`flutter devices failed with code ${code}: ${stderr}`));
+            }
+            else {
+                resolve(stdout);
+            }
+        });
+        proc.on("error", (err) => {
+            reject(new Error(`Failed to start flutter devices: ${err.message}`));
+        });
+    });
+}
+//# sourceMappingURL=flutter-devices.js.map

package/dist/flutter-devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter-devices.js","sourceRoot":"","sources":["../src/flutter-devices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAU3C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAiB;IACpD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAM3B,CAAC;QAEH,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,GAAG,EAAE,CAAC,CAAC,GAAG;SACX,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,2CAA2C,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,QAAiB;IACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACtC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/flutter-run.d.ts

@@ -0,0 +1,22 @@
+export interface FlutterRunResult {
+    run_id: number;
+    success: boolean;
+    error?: string;
+}
+export declare function flutterRun(projectDir: string, device: string, isDebug: boolean, dontDetach: boolean): Promise<FlutterRunResult>;
+export declare function flutterHotReload(runId: number): {
+    success: boolean;
+    error?: string;
+};
+export declare function flutterHotRestart(runId: number): {
+    success: boolean;
+    error?: string;
+};
+export declare function flutterKill(runId: number): {
+    success: boolean;
+    error?: string;
+};
+export declare function flutterLogs(runId: number): {
+    logs: string;
+    error?: string;
+};