flutter-dev-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,346 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { flutterTest, flutterGetResult } from "./flutter-test.js";
+import { flutterRun, flutterHotReload, flutterHotRestart, flutterKill, flutterLogs, } from "./flutter-run.js";
+import { flutterAnalyze } from "./flutter-analyze.js";
+import { flutterDevices } from "./flutter-devices.js";
+import { flutterClean, flutterPubGet, flutterPubAdd, flutterGenL10n, flutterBuildRunner } from "./flutter-commands.js";
+import { validateProjectDir, validatePackageName, validateTestPath, validateDeviceId } from "./validate.js";
+const server = new McpServer({
+    name: "flutter-dev-mcp",
+    version: "1.0.0",
+});
+// --- flutter_test ---
+server.registerTool("flutter_test", {
+    description: "Run flutter tests and return a summary of failed tests. Use flutter_get_result to get full error details for specific test IDs.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+        test_path: z
+            .string()
+            .optional()
+            .describe("Specific test file or directory to run (e.g. test/widget_test.dart)"),
+        test_name: z
+            .string()
+            .optional()
+            .describe("Filter tests by name (plain string match)"),
+    },
+}, async ({ project_dir, test_path, test_name }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const path = test_path ? validateTestPath(test_path) : undefined;
+        const result = await flutterTest(dir, path, test_name);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- flutter_get_result ---
+server.registerTool("flutter_get_result", {
+    description: "Get full error details for specific test IDs from a previous flutter_test run. Output is capped at 24KB.",
+    inputSchema: {
+        test_run_id: z.number().describe("The test_run_id from a previous flutter_test call"),
+        test_ids: z.array(z.number()).describe("Array of test_id values to get full details for"),
+    },
+}, ({ test_run_id, test_ids }) => {
+    try {
+        const results = flutterGetResult(test_run_id, test_ids);
+        return {
+            content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- flutter_run ---
+server.registerTool("flutter_run", {
+    description: "Start a Flutter app. Returns a run_id for use with hot_reload, hot_restart, and logs tools.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+        device: z
+            .string()
+            .default("")
+            .describe("Target device ID (e.g. 'chrome', 'macos', an emulator ID). Empty for default."),
+        is_debug: z.boolean().default(true).describe("Run in debug mode (true) or release mode (false)"),
+        dont_detach: z.boolean().default(false).describe("If true, wait for the app to finish instead of returning immediately after start"),
+    },
+}, async ({ project_dir, device, is_debug, dont_detach }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const dev = device ? validateDeviceId(device) : "";
+        const result = await flutterRun(dir, dev, is_debug, dont_detach);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- flutter_hot_reload ---
+server.registerTool("flutter_hot_reload", {
+    description: "Trigger a hot reload on a running Flutter app.",
+    inputSchema: {
+        run_id: z.number().describe("The run_id from a previous flutter_run call"),
+    },
+}, ({ run_id }) => {
+    const result = flutterHotReload(run_id);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        isError: !result.success,
+    };
+});
+// --- flutter_hot_restart ---
+server.registerTool("flutter_hot_restart", {
+    description: "Trigger a hot restart on a running Flutter app.",
+    inputSchema: {
+        run_id: z.number().describe("The run_id from a previous flutter_run call"),
+    },
+}, ({ run_id }) => {
+    const result = flutterHotRestart(run_id);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        isError: !result.success,
+    };
+});
+// --- flutter_kill ---
+server.registerTool("flutter_kill", {
+    description: "Kill a running Flutter app.",
+    inputSchema: {
+        run_id: z.number().describe("The run_id from a previous flutter_run call"),
+    },
+}, ({ run_id }) => {
+    const result = flutterKill(run_id);
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        isError: !result.success,
+    };
+});
+// --- flutter_logs ---
+server.registerTool("flutter_logs", {
+    description: "Get logs from a running Flutter app. Returns the most recent logs, capped at 24KB.",
+    inputSchema: {
+        run_id: z.number().describe("The run_id from a previous flutter_run call"),
+    },
+}, ({ run_id }) => {
+    const result = flutterLogs(run_id);
+    return {
+        content: [{ type: "text", text: result.error ? JSON.stringify(result) : result.logs }],
+        isError: !!result.error,
+    };
+});
+// --- flutter_analyze ---
+server.registerTool("flutter_analyze", {
+    description: "Run static analysis on a Flutter project. Returns all errors, warnings, and info-level issues with file locations and rule names.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+    },
+}, async ({ project_dir }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const result = await flutterAnalyze(dir);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- flutter_devices ---
+server.registerTool("flutter_devices", {
+    description: "List available Flutter devices (simulators, emulators, physical devices).",
+    inputSchema: {
+        wireless: z.boolean().default(false).describe("Include wirelessly connected devices (slower, default false)"),
+    },
+}, async ({ wireless }) => {
+    try {
+        const devices = await flutterDevices(wireless);
+        return {
+            content: [{ type: "text", text: JSON.stringify(devices, null, 2) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        error: err instanceof Error ? err.message : String(err),
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// --- flutter_clean ---
+server.registerTool("flutter_clean", {
+    description: "Run flutter clean to delete build artifacts. Useful when builds get into a bad state.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+    },
+}, async ({ project_dir }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const result = await flutterClean(dir);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: !result.success,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }) }],
+            isError: true,
+        };
+    }
+});
+// --- flutter_pub_get ---
+server.registerTool("flutter_pub_get", {
+    description: "Run flutter pub get to resolve and download dependencies.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+    },
+}, async ({ project_dir }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const result = await flutterPubGet(dir);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: !result.success,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }) }],
+            isError: true,
+        };
+    }
+});
+// --- flutter_pub_add ---
+server.registerTool("flutter_pub_add", {
+    description: "Add one or more packages to the project's dependencies.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+        packages: z.array(z.string()).describe("Package names to add (e.g. ['http', 'provider'])"),
+        dev: z.boolean().default(false).describe("Add as dev dependency"),
+    },
+}, async ({ project_dir, packages, dev }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const validatedPackages = packages.map(validatePackageName);
+        const result = await flutterPubAdd(dir, validatedPackages, dev);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: !result.success,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }) }],
+            isError: true,
+        };
+    }
+});
+// --- flutter_gen_l10n ---
+server.registerTool("flutter_gen_l10n", {
+    description: "Generate localization files from ARB files.",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+    },
+}, async ({ project_dir }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const result = await flutterGenL10n(dir);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: !result.success,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }) }],
+            isError: true,
+        };
+    }
+});
+// --- flutter_build_runner ---
+server.registerTool("flutter_build_runner", {
+    description: "Run build_runner to generate code (freezed, json_serializable, drift, etc.).",
+    inputSchema: {
+        project_dir: z.string().describe("Path to the Flutter project directory"),
+        delete_conflicting: z.boolean().default(true).describe("Delete conflicting outputs before building (usually what you want)"),
+    },
+}, async ({ project_dir, delete_conflicting }) => {
+    try {
+        const dir = validateProjectDir(project_dir);
+        const result = await flutterBuildRunner(dir, delete_conflicting);
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            isError: !result.success,
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: "text", text: JSON.stringify({ error: err instanceof Error ? err.message : String(err) }) }],
+            isError: true,
+        };
+    }
+});
+// --- Start server ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Flutter Dev MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Validates and normalizes a project directory path.
+ * - Resolves to absolute path
+ * - Normalizes away ../ traversal
+ * - Verifies the directory exists
+ * - Verifies it looks like a Flutter project (has pubspec.yaml)
+ */
+export declare function validateProjectDir(projectDir: string): string;
+/**
+ * Validates a package name for flutter pub add.
+ * Package names must be valid Dart package identifiers, optionally with a version constraint.
+ * e.g. "http", "provider:^6.0.0", "http:any"
+ */
+export declare function validatePackageName(pkg: string): string;
+/**
+ * Validates a device ID string for flutter run.
+ */
+export declare function validateDeviceId(device: string): string;
+/**
+ * Validates a test path - must be a relative path within the project, no traversal.
+ */
+export declare function validateTestPath(testPath: string): string;

package/dist/validate.js

@@ -0,0 +1,63 @@
+import { resolve, normalize } from "node:path";
+import { existsSync, statSync } from "node:fs";
+/**
+ * Validates and normalizes a project directory path.
+ * - Resolves to absolute path
+ * - Normalizes away ../ traversal
+ * - Verifies the directory exists
+ * - Verifies it looks like a Flutter project (has pubspec.yaml)
+ */
+export function validateProjectDir(projectDir) {
+    const normalized = resolve(normalize(projectDir));
+    if (!existsSync(normalized)) {
+        throw new Error(`Directory does not exist: ${normalized}`);
+    }
+    const stat = statSync(normalized);
+    if (!stat.isDirectory()) {
+        throw new Error(`Not a directory: ${normalized}`);
+    }
+    const pubspecPath = resolve(normalized, "pubspec.yaml");
+    if (!existsSync(pubspecPath)) {
+        throw new Error(`Not a Flutter project (no pubspec.yaml found): ${normalized}`);
+    }
+    return normalized;
+}
+/**
+ * Validates a package name for flutter pub add.
+ * Package names must be valid Dart package identifiers, optionally with a version constraint.
+ * e.g. "http", "provider:^6.0.0", "http:any"
+ */
+export function validatePackageName(pkg) {
+    // Must not start with a dash (flag injection)
+    if (pkg.startsWith("-")) {
+        throw new Error(`Invalid package name (cannot start with -): ${pkg}`);
+    }
+    // Basic format: alphanumeric/underscore, optionally followed by :version
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*(?::.*)?$/.test(pkg)) {
+        throw new Error(`Invalid package name: ${pkg}`);
+    }
+    return pkg;
+}
+/**
+ * Validates a device ID string for flutter run.
+ */
+export function validateDeviceId(device) {
+    if (device.startsWith("-")) {
+        throw new Error(`Invalid device ID (cannot start with -): ${device}`);
+    }
+    return device;
+}
+/**
+ * Validates a test path - must be a relative path within the project, no traversal.
+ */
+export function validateTestPath(testPath) {
+    const normalized = normalize(testPath);
+    if (normalized.startsWith("/") || normalized.startsWith("..")) {
+        throw new Error(`Test path must be relative and within the project: ${testPath}`);
+    }
+    if (normalized.startsWith("-")) {
+        throw new Error(`Invalid test path (cannot start with -): ${testPath}`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;IAElD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,6BAA6B,UAAU,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kDAAkD,UAAU,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,8CAA8C;IAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,+CAA+C,GAAG,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,yEAAyE;IACzE,IAAI,CAAC,kCAAkC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,4CAA4C,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,sDAAsD,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "flutter-dev-mcp",
+  "version": "1.0.0",
+  "description": "MCP server that gives AI coding agents first-class Flutter development tools",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "flutter-dev-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "flutter",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "dart",
+    "testing",
+    "hot-reload",
+    "claude",
+    "codex"
+  ],
+  "author": "zafnz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zafnz/flutter-dev-mcp.git"
+  },
+  "homepage": "https://github.com/zafnz/flutter-dev-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/zafnz/flutter-dev-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "typescript": "^5.9.3"
+  }
+}