@tac0de/flutter-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tac0de
+
+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,132 @@
+# flutter-mcp
+
+> Repo-aware and Verify-first Flutter MCP Server for AI coding agents
+
+An MCP (Model Context Protocol) server that helps AI coding agents better understand and work with Flutter projects. It provides project analysis, code validation, and dependency checking capabilities.
+
+## 🎯 Expected Impact
+
+### With Flutter MCP
+
+```
+User: "Add a list widget to the home screen"
+
+AI Thought Process:
+1. flutter_detect_project → Confirms Flutter project ✓
+2. flutter_analyze_project → Understands project structure (lib/, android/, ios/)
+3. flutter_list_widgets → Discovers 23 existing widgets, learns patterns
+4. flutter_validate_code → Validates generated code before suggesting
+5. → Adds code in correct location with proper patterns
+```
+
+### Without Flutter MCP (Typical AI Coding Agent)
+
+```
+User: "Add a list widget to the home screen"
+
+AI Thought Process:
+1. Not sure if it's a Flutter project → Proceeds with assumptions
+2. Doesn't know file structure → Randomly searches files
+3. Unaware of existing code style → Generates code based on guesses
+4. Code may or may not work → Submits anyway
+5. → Errors occur, retries needed
+```
+
+## 📊 Comparison
+
+| Aspect            | With Flutter MCP                          | Without MCP                      |
+| ----------------- | ----------------------------------------- | -------------------------------- |
+| Project Awareness | Accurately identifies via pubspec.yaml    | Guesses from filenames           |
+| Code Validation   | Validates syntax/imports before execution | Discovers errors after execution |
+| Dependency Check  | Detects version conflicts upfront         | Errors occur during install      |
+| Code Consistency  | Analyzes existing widget patterns first   | Inconsistent style each time     |
+| Retry Rate        | Low (pre-validated)                       | High (fix after execution)       |
+
+## ✨ Key Features
+
+### Repo-aware Analysis
+
+- **flutter_detect_project**: Detect if directory is a Flutter project and identify type (app/package/module)
+- **flutter_analyze_project**: Analyze project structure including platforms and file organization
+- **flutter_get_project_info**: Extract detailed project information from pubspec.yaml
+- **flutter_list_widgets**: List all Flutter widgets (StatelessWidget, StatefulWidget) in the project
+
+### Verify-first Validation
+
+- **flutter_validate_code**: Validate Flutter/Dart code before execution with syntax checks, import validation, and common issue detection
+- **flutter_check_dependencies**: Check dependencies for compatibility, version conflicts, and availability
+
+## 🚀 Installation & Configuration
+
+### MCP Server Setup
+
+Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "flutter": {
+      "command": "npx",
+      "args": ["-y", "@tac0de/flutter-mcp"]
+    }
+  }
+}
+```
+
+**For Claude Desktop**: Add the above to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows), then restart Claude.
+
+**For other MCP clients**: Use the same configuration in your client's settings file.
+
+After restart, the server will automatically analyze and validate Flutter projects.
+
+## 🛠️ Available Tools
+
+### flutter_detect_project
+
+Detect if the current directory is a Flutter project.
+
+### flutter_analyze_project
+
+Analyze Flutter project structure.
+
+### flutter_get_project_info
+
+Get detailed Flutter project information from pubspec.yaml.
+
+### flutter_validate_code
+
+Validate Flutter/Dart code before execution.
+
+### flutter_check_dependencies
+
+Check Flutter project dependencies for compatibility and issues.
+
+### flutter_list_widgets
+
+List all Flutter widgets found in the project.
+
+## 💻 Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+## 📋 Requirements
+
+- Node.js >= 18
+- npm >= 9
+
+## 📄 License
+
+MIT
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,226 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode, } from "@modelcontextprotocol/sdk/types.js";
+// Flutter project utilities
+import { detectFlutterProject, analyzeFlutterProject, getFlutterProjectInfo, } from "./utils/flutter.js";
+// Error handler for uncaught exceptions
+process.on("uncaughtException", (error) => {
+    console.error("Uncaught exception:", error);
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason, promise) => {
+    console.error("Unhandled rejection at:", promise, "reason:", reason);
+    process.exit(1);
+});
+// Create server instance
+const server = new Server({
+    name: "flutter-mcp",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "flutter_detect_project",
+                description: "Detect if the current directory is a Flutter project. Returns project type, Flutter version, and basic configuration.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to check (default: current working directory)",
+                        },
+                    },
+                },
+            },
+            {
+                name: "flutter_analyze_project",
+                description: "Analyze Flutter project structure including dependencies, project type (app/module/package), and file organization. Returns a comprehensive overview of the codebase architecture.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to Flutter project (default: current working directory)",
+                        },
+                    },
+                },
+            },
+            {
+                name: "flutter_get_project_info",
+                description: "Get detailed Flutter project information including package name, SDK versions, dependencies, material design version, and project configuration from pubspec.yaml.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to Flutter project (default: current working directory)",
+                        },
+                    },
+                },
+            },
+            {
+                name: "flutter_validate_code",
+                description: "Validate Flutter/Dart code before execution. Checks for syntax errors, imports, and common issues. Returns validation results with specific error locations and suggestions.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        code: {
+                            type: "string",
+                            description: "Dart code to validate",
+                        },
+                        filePath: {
+                            type: "string",
+                            description: "Expected file path for better error reporting (optional)",
+                        },
+                    },
+                    required: ["code"],
+                },
+            },
+            {
+                name: "flutter_check_dependencies",
+                description: "Check Flutter project dependencies for compatibility, version conflicts, and availability. Analyzes pubspec.yaml and provides recommendations.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to Flutter project (default: current working directory)",
+                        },
+                    },
+                },
+            },
+            {
+                name: "flutter_list_widgets",
+                description: "List all Flutter widgets (StatelessWidget, StatefulWidget) found in the project. Useful for understanding the UI component structure.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        path: {
+                            type: "string",
+                            description: "Path to Flutter project (default: current working directory)",
+                        },
+                        includeFullPath: {
+                            type: "boolean",
+                            description: "Include full file paths in results (default: false)",
+                        },
+                    },
+                },
+            },
+        ],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "flutter_detect_project": {
+                const path = args?.path || process.cwd();
+                const result = await detectFlutterProject(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "flutter_analyze_project": {
+                const path = args?.path || process.cwd();
+                const result = await analyzeFlutterProject(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "flutter_get_project_info": {
+                const path = args?.path || process.cwd();
+                const result = await getFlutterProjectInfo(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "flutter_validate_code": {
+                const code = args?.code;
+                const filePath = args?.filePath;
+                if (!code) {
+                    throw new McpError(ErrorCode.InvalidParams, "Code is required for validation");
+                }
+                const result = await validateDartCode(code, filePath);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "flutter_check_dependencies": {
+                const path = args?.path || process.cwd();
+                const result = await checkDependencies(path);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            case "flutter_list_widgets": {
+                const path = args?.path || process.cwd();
+                const includeFullPath = args?.includeFullPath || false;
+                const result = await listWidgets(path, includeFullPath);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof McpError) {
+            throw error;
+        }
+        throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+});
+// Import tool implementations
+import { validateDartCode } from "./tools/validate.js";
+import { checkDependencies } from "./tools/dependencies.js";
+import { listWidgets } from "./tools/widgets.js";
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Flutter MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    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/tools/dependencies.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Check Flutter project dependencies for compatibility and issues
+ */
+export declare function checkDependencies(projectPath: string): Promise<{
+    healthy: boolean;
+    dependencies: DependencyInfo[];
+    devDependencies: DependencyInfo[];
+    issues: DependencyIssue[];
+    recommendations: string[];
+}>;
+interface DependencyInfo {
+    name: string;
+    version: string;
+    type: "runtime" | "development";
+    isFlutterSdk?: boolean;
+    isGitDependency?: boolean;
+    isPathDependency?: boolean;
+    isHostedDependency?: boolean;
+    hasVersionConstraint: boolean;
+}
+interface DependencyIssue {
+    type: "error" | "warning";
+    message: string;
+    dependency: string | null;
+}
+export {};
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/tools/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/tools/dependencies.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC,CA0KD;AAgCD,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,GAAG,aAAa,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/tools/dependencies.js

@@ -0,0 +1,172 @@
+import * as path from "path";
+import { existsSync } from "fs";
+import { readPubspecYaml } from "../utils/flutter.js";
+/**
+ * Check Flutter project dependencies for compatibility and issues
+ */
+export async function checkDependencies(projectPath) {
+    const result = {
+        healthy: true,
+        dependencies: [],
+        devDependencies: [],
+        issues: [],
+        recommendations: [],
+    };
+    try {
+        const pubspec = await readPubspecYaml(projectPath);
+        if (!pubspec) {
+            result.issues.push({
+                type: "error",
+                message: "pubspec.yaml not found",
+                dependency: null,
+            });
+            result.healthy = false;
+            return result;
+        }
+        // Check if Flutter SDK is specified
+        if (!pubspec.environment?.sdk) {
+            result.issues.push({
+                type: "warning",
+                message: "Dart SDK version not specified in environment",
+                dependency: "sdk",
+            });
+            result.recommendations.push("Add SDK constraint to pubspec.yaml: environment: sdk: '>=3.0.0 <4.0.0'");
+        }
+        // Analyze dependencies
+        if (pubspec.dependencies) {
+            for (const [name, version] of Object.entries(pubspec.dependencies)) {
+                const depInfo = {
+                    name,
+                    version,
+                    type: "runtime",
+                    isFlutterSdk: name === "flutter",
+                    hasVersionConstraint: version !== "any",
+                };
+                // Check for any version
+                if (version === "any") {
+                    result.issues.push({
+                        type: "warning",
+                        message: `Dependency '${name}' uses 'any' version constraint`,
+                        dependency: name,
+                    });
+                    result.recommendations.push(`Specify a version constraint for '${name}' instead of 'any'`);
+                    depInfo.hasVersionConstraint = false;
+                }
+                // Check for git dependencies
+                if (typeof version === "string" && version.startsWith("git:")) {
+                    depInfo.isGitDependency = true;
+                    result.recommendations.push(`Consider using a published version of '${name}' instead of git dependency for stability`);
+                }
+                // Check for path dependencies
+                if (typeof version === "string" && version.startsWith("path:")) {
+                    depInfo.isPathDependency = true;
+                    const localPath = path.join(projectPath, version.replace("path:", ""));
+                    if (!existsSync(localPath)) {
+                        result.issues.push({
+                            type: "error",
+                            message: `Path dependency '${name}' points to non-existent path: ${localPath}`,
+                            dependency: name,
+                        });
+                        result.healthy = false;
+                    }
+                }
+                // Check for hosted dependencies with version
+                if (typeof version === "string" && !version.startsWith("git:") &&
+                    !version.startsWith("path:") && version !== "any") {
+                    depInfo.isHostedDependency = true;
+                    // Check version constraint format
+                    if (!isValidVersionConstraint(version)) {
+                        result.issues.push({
+                            type: "warning",
+                            message: `Invalid version constraint for '${name}': ${version}`,
+                            dependency: name,
+                        });
+                    }
+                }
+                result.dependencies.push(depInfo);
+            }
+        }
+        // Analyze dev_dependencies
+        if (pubspec.dev_dependencies) {
+            for (const [name, version] of Object.entries(pubspec.dev_dependencies)) {
+                const depInfo = {
+                    name,
+                    version,
+                    type: "development",
+                    isFlutterSdk: name === "flutter_test",
+                    hasVersionConstraint: version !== "any",
+                };
+                // Same checks as above
+                if (version === "any") {
+                    result.issues.push({
+                        type: "warning",
+                        message: `Dev dependency '${name}' uses 'any' version constraint`,
+                        dependency: name,
+                    });
+                    depInfo.hasVersionConstraint = false;
+                }
+                if (typeof version === "string" && version.startsWith("git:")) {
+                    depInfo.isGitDependency = true;
+                }
+                if (typeof version === "string" && version.startsWith("path:")) {
+                    depInfo.isPathDependency = true;
+                }
+                result.devDependencies.push(depInfo);
+            }
+        }
+        // Check for common testing dependencies
+        const hasTestDependencies = pubspec.dev_dependencies?.flutter_test ||
+            pubspec.dev_dependencies?.build_runner ||
+            pubspec.dev_dependencies?.mockito;
+        if (!hasTestDependencies && result.devDependencies.length > 0) {
+            result.recommendations.push("Consider adding testing dependencies like flutter_test for better test coverage");
+        }
+        // Check for flutter_lints
+        if (!pubspec.dev_dependencies?.flutter_lints) {
+            result.recommendations.push("Add flutter_lints package for better code quality checks: dev_dependencies: flutter_lints: ^3.0.0");
+        }
+        // Count dependencies
+        const totalDeps = result.dependencies.length + result.devDependencies.length;
+        if (totalDeps > 50) {
+            result.issues.push({
+                type: "warning",
+                message: `Project has ${totalDeps} dependencies. Consider reducing dependencies for better maintainability.`,
+                dependency: null,
+            });
+        }
+    }
+    catch (error) {
+        result.issues.push({
+            type: "error",
+            message: `Failed to analyze dependencies: ${error instanceof Error ? error.message : String(error)}`,
+            dependency: null,
+        });
+        result.healthy = false;
+    }
+    return result;
+}
+/**
+ * Check if version constraint is valid
+ */
+function isValidVersionConstraint(constraint) {
+    // Basic version constraint validation
+    // Supports: ^1.0.0, >=1.0.0, <2.0.0, 1.0.0, etc.
+    // Check for caret
+    if (constraint.startsWith("^")) {
+        return /^\^\d+\.\d+\.\d+$/.test(constraint);
+    }
+    // Check for comparison operators
+    if (/^[<>]=?\s*\d+\.\d+\.\d+/.test(constraint)) {
+        return true;
+    }
+    // Check for exact version
+    if (/^\d+\.\d+\.\d+$/.test(constraint)) {
+        return true;
+    }
+    // Check for range
+    if (/^\d+\.\d+\.\d+\s*<=\s*version\s*<\s*\d+\.\d+\.\d+/.test(constraint)) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/tools/dependencies.js.map

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

package/dist/tools/validate.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Validate Dart/Flutter code before execution
+ * Performs syntax checks, import validation, and common issue detection
+ */
+export declare function validateDartCode(code: string, filePath?: string): Promise<{
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    suggestions: string[];
+    metadata: {
+        lineCount: number;
+        hasImports: boolean;
+        hasMainFunction: boolean;
+        hasWidgetClass: boolean;
+        estimatedComplexity: "low" | "medium" | "high";
+    };
+}>;
+interface ValidationError {
+    line: number;
+    column: number;
+    message: string;
+    severity: "error";
+    code: string;
+}
+interface ValidationWarning {
+    line: number;
+    column: number;
+    message: string;
+    severity: "warning" | "info";
+    code: string;
+}
+export {};
+//# sourceMappingURL=validate.d.ts.map

package/dist/tools/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/tools/validate.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IACT,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,EAAE,OAAO,CAAC;QACxB,mBAAmB,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;KAChD,CAAC;CACH,CAAC,CAiND;AA6CD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd"}