flutter-skill-mcp 0.2.0

package/README.md

@@ -0,0 +1,71 @@
+# flutter-skill-mcp
+
+> MCP Server for Flutter app automation - Give your AI Agent eyes and hands inside your Flutter app
+
+[![npm version](https://badge.fury.io/js/flutter-skill-mcp.svg)](https://www.npmjs.com/package/flutter-skill-mcp)
+[![pub version](https://img.shields.io/pub/v/flutter_skill.svg)](https://pub.dev/packages/flutter_skill)
+
+## Installation
+
+```bash
+npm install -g flutter-skill-mcp
+# or use directly with npx
+npx flutter-skill-mcp
+```
+
+**Prerequisites**: [Flutter SDK](https://docs.flutter.dev/get-started/install) or [Dart SDK](https://dart.dev/get-dart)
+
+## MCP Configuration
+
+Add to your MCP config (Cursor, Windsurf, Claude Desktop):
+
+```json
+{
+  "flutter-skill": {
+    "command": "npx",
+    "args": ["flutter-skill-mcp"]
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "flutter-skill": {
+    "command": "flutter-skill-mcp"
+  }
+}
+```
+
+## Features
+
+- **UI Inspection**: Widget tree, text content, element properties
+- **Interactions**: Tap, double tap, long press, swipe, drag, scroll
+- **State Validation**: Text values, checkbox state, wait for elements
+- **Screenshots**: Full app or specific elements
+- **Navigation**: Routes, go back, navigation stack
+- **Debug**: Logs, errors, performance metrics
+
+## 25+ MCP Tools
+
+| Category | Tools |
+|----------|-------|
+| Connection | `connect_app`, `launch_app` |
+| UI Inspection | `inspect`, `get_widget_tree`, `get_widget_properties`, `get_text_content`, `find_by_type` |
+| Interactions | `tap`, `double_tap`, `long_press`, `swipe`, `drag`, `scroll_to`, `enter_text` |
+| State | `get_text_value`, `get_checkbox_state`, `get_slider_value`, `wait_for_element`, `wait_for_gone` |
+| Screenshot | `screenshot`, `screenshot_element` |
+| Navigation | `get_current_route`, `go_back`, `get_navigation_stack` |
+| Debug | `get_logs`, `get_errors`, `get_performance`, `clear_logs` |
+| Dev | `hot_reload`, `pub_search` |
+
+## Links
+
+- [GitHub](https://github.com/ai-dashboad/flutter-skill)
+- [pub.dev](https://pub.dev/packages/flutter_skill)
+- [Documentation](https://github.com/ai-dashboad/flutter-skill#readme)
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Find the dart directory
+const dartDir = path.join(__dirname, '..', 'dart');
+const serverScript = path.join(dartDir, 'bin', 'server.dart');
+
+// Check if Dart is installed
+function checkDart() {
+  try {
+    require('child_process').execSync('dart --version', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// Check if Flutter is installed
+function checkFlutter() {
+  try {
+    require('child_process').execSync('flutter --version', { stdio: 'ignore' });
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+if (!checkDart()) {
+  console.error('Error: Dart SDK not found. Please install Flutter/Dart first.');
+  console.error('  https://docs.flutter.dev/get-started/install');
+  process.exit(1);
+}
+
+if (!checkFlutter()) {
+  console.error('Warning: Flutter SDK not found. Some features may not work.');
+}
+
+// Check if server script exists
+if (!fs.existsSync(serverScript)) {
+  console.error('Error: Server script not found at:', serverScript);
+  process.exit(1);
+}
+
+// Get dependencies first (use flutter pub for Flutter packages)
+const pubCmd = checkFlutter() ? 'flutter' : 'dart';
+const pubGet = spawn(pubCmd, ['pub', 'get'], {
+  cwd: dartDir,
+  stdio: 'inherit'
+});
+
+pubGet.on('close', (code) => {
+  if (code !== 0) {
+    console.error('Failed to get dependencies');
+    process.exit(1);
+  }
+
+  // Start the MCP server
+  const server = spawn('dart', ['run', serverScript], {
+    cwd: dartDir,
+    stdio: 'inherit'
+  });
+
+  server.on('close', (code) => {
+    process.exit(code || 0);
+  });
+
+  // Forward signals
+  process.on('SIGINT', () => server.kill('SIGINT'));
+  process.on('SIGTERM', () => server.kill('SIGTERM'));
+});

package/dart/.dart_tool/package_config.json

@@ -0,0 +1,196 @@
+{
+  "configVersion": 2,
+  "packages": [
+    {
+      "name": "async",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/async-2.13.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "boolean_selector",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/boolean_selector-2.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "characters",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/characters-1.4.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "clock",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/clock-1.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "collection",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/collection-1.19.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "fake_async",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/fake_async-1.3.3",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "flutter",
+      "rootUri": "file:///Users/cw/development/flutter/packages/flutter",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "flutter_test",
+      "rootUri": "file:///Users/cw/development/flutter/packages/flutter_test",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "http",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/http-1.6.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "http_parser",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/http_parser-4.1.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "leak_tracker",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/leak_tracker-11.0.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "leak_tracker_flutter_testing",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/leak_tracker_flutter_testing-3.0.10",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "leak_tracker_testing",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/leak_tracker_testing-3.0.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.2"
+    },
+    {
+      "name": "lints",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/lints-3.0.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.0"
+    },
+    {
+      "name": "logging",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/logging-1.3.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "matcher",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/matcher-0.12.18",
+      "packageUri": "lib/",
+      "languageVersion": "3.7"
+    },
+    {
+      "name": "material_color_utilities",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/material_color_utilities-0.13.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "meta",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/meta-1.17.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "path",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/path-1.9.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "sky_engine",
+      "rootUri": "file:///Users/cw/development/flutter/bin/cache/pkg/sky_engine",
+      "packageUri": "lib/",
+      "languageVersion": "3.9"
+    },
+    {
+      "name": "source_span",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/source_span-1.10.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "stack_trace",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/stack_trace-1.12.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "stream_channel",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/stream_channel-2.1.4",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "string_scanner",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/string_scanner-1.4.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "term_glyph",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/term_glyph-1.2.2",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "test_api",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/test_api-0.7.8",
+      "packageUri": "lib/",
+      "languageVersion": "3.7"
+    },
+    {
+      "name": "typed_data",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/typed_data-1.4.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.5"
+    },
+    {
+      "name": "vector_math",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/vector_math-2.2.0",
+      "packageUri": "lib/",
+      "languageVersion": "3.1"
+    },
+    {
+      "name": "vm_service",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/vm_service-14.3.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.3"
+    },
+    {
+      "name": "web",
+      "rootUri": "file:///Users/cw/.pub-cache/hosted/pub.flutter-io.cn/web-1.1.1",
+      "packageUri": "lib/",
+      "languageVersion": "3.4"
+    },
+    {
+      "name": "flutter_skill",
+      "rootUri": "../",
+      "packageUri": "lib/",
+      "languageVersion": "3.0"
+    }
+  ],
+  "generator": "pub",
+  "generatorVersion": "3.11.0-296.4.beta",
+  "flutterRoot": "file:///Users/cw/development/flutter",
+  "flutterVersion": "3.41.0-0.1.pre",
+  "pubCache": "file:///Users/cw/.pub-cache"
+}

package/dart/.dart_tool/package_graph.json

@@ -0,0 +1,258 @@
+{
+  "roots": [
+    "flutter_skill"
+  ],
+  "packages": [
+    {
+      "name": "flutter_skill",
+      "version": "0.2.0",
+      "dependencies": [
+        "flutter",
+        "http",
+        "logging",
+        "path",
+        "vm_service"
+      ],
+      "devDependencies": [
+        "flutter_test",
+        "lints"
+      ]
+    },
+    {
+      "name": "lints",
+      "version": "3.0.0",
+      "dependencies": []
+    },
+    {
+      "name": "flutter_test",
+      "version": "0.0.0",
+      "dependencies": [
+        "clock",
+        "collection",
+        "fake_async",
+        "flutter",
+        "leak_tracker_flutter_testing",
+        "matcher",
+        "meta",
+        "path",
+        "stack_trace",
+        "stream_channel",
+        "test_api",
+        "vector_math"
+      ]
+    },
+    {
+      "name": "logging",
+      "version": "1.3.0",
+      "dependencies": []
+    },
+    {
+      "name": "path",
+      "version": "1.9.1",
+      "dependencies": []
+    },
+    {
+      "name": "http",
+      "version": "1.6.0",
+      "dependencies": [
+        "async",
+        "http_parser",
+        "meta",
+        "web"
+      ]
+    },
+    {
+      "name": "vm_service",
+      "version": "14.3.1",
+      "dependencies": []
+    },
+    {
+      "name": "flutter",
+      "version": "0.0.0",
+      "dependencies": [
+        "characters",
+        "collection",
+        "material_color_utilities",
+        "meta",
+        "sky_engine",
+        "vector_math"
+      ]
+    },
+    {
+      "name": "stream_channel",
+      "version": "2.1.4",
+      "dependencies": [
+        "async"
+      ]
+    },
+    {
+      "name": "meta",
+      "version": "1.17.0",
+      "dependencies": []
+    },
+    {
+      "name": "collection",
+      "version": "1.19.1",
+      "dependencies": []
+    },
+    {
+      "name": "leak_tracker_flutter_testing",
+      "version": "3.0.10",
+      "dependencies": [
+        "flutter",
+        "leak_tracker",
+        "leak_tracker_testing",
+        "matcher",
+        "meta"
+      ]
+    },
+    {
+      "name": "vector_math",
+      "version": "2.2.0",
+      "dependencies": []
+    },
+    {
+      "name": "stack_trace",
+      "version": "1.12.1",
+      "dependencies": [
+        "path"
+      ]
+    },
+    {
+      "name": "clock",
+      "version": "1.1.2",
+      "dependencies": []
+    },
+    {
+      "name": "fake_async",
+      "version": "1.3.3",
+      "dependencies": [
+        "clock",
+        "collection"
+      ]
+    },
+    {
+      "name": "matcher",
+      "version": "0.12.18",
+      "dependencies": [
+        "async",
+        "meta",
+        "stack_trace",
+        "term_glyph",
+        "test_api"
+      ]
+    },
+    {
+      "name": "test_api",
+      "version": "0.7.8",
+      "dependencies": [
+        "async",
+        "boolean_selector",
+        "collection",
+        "meta",
+        "source_span",
+        "stack_trace",
+        "stream_channel",
+        "string_scanner",
+        "term_glyph"
+      ]
+    },
+    {
+      "name": "web",
+      "version": "1.1.1",
+      "dependencies": []
+    },
+    {
+      "name": "http_parser",
+      "version": "4.1.2",
+      "dependencies": [
+        "collection",
+        "source_span",
+        "string_scanner",
+        "typed_data"
+      ]
+    },
+    {
+      "name": "async",
+      "version": "2.13.0",
+      "dependencies": [
+        "collection",
+        "meta"
+      ]
+    },
+    {
+      "name": "sky_engine",
+      "version": "0.0.0",
+      "dependencies": []
+    },
+    {
+      "name": "material_color_utilities",
+      "version": "0.13.0",
+      "dependencies": [
+        "collection"
+      ]
+    },
+    {
+      "name": "characters",
+      "version": "1.4.1",
+      "dependencies": []
+    },
+    {
+      "name": "leak_tracker_testing",
+      "version": "3.0.2",
+      "dependencies": [
+        "leak_tracker",
+        "matcher",
+        "meta"
+      ]
+    },
+    {
+      "name": "leak_tracker",
+      "version": "11.0.2",
+      "dependencies": [
+        "clock",
+        "collection",
+        "meta",
+        "path",
+        "vm_service"
+      ]
+    },
+    {
+      "name": "term_glyph",
+      "version": "1.2.2",
+      "dependencies": []
+    },
+    {
+      "name": "string_scanner",
+      "version": "1.4.1",
+      "dependencies": [
+        "source_span"
+      ]
+    },
+    {
+      "name": "source_span",
+      "version": "1.10.1",
+      "dependencies": [
+        "collection",
+        "path",
+        "term_glyph"
+      ]
+    },
+    {
+      "name": "boolean_selector",
+      "version": "2.1.2",
+      "dependencies": [
+        "source_span",
+        "string_scanner"
+      ]
+    },
+    {
+      "name": "typed_data",
+      "version": "1.4.0",
+      "dependencies": [
+        "collection"
+      ]
+    }
+  ],
+  "configVersion": 1
+}

package/dart/.dart_tool/version

@@ -0,0 +1 @@
+3.41.0-0.1.pre

package/dart/bin/server.dart

@@ -0,0 +1,3 @@
+import 'package:flutter_skill/src/cli/server.dart';
+
+void main(List<String> args) => runServer(args);