Flutter Inspector MCP Server

by Arenukvern
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Interfaces with Dart VM Service Protocol to access Flutter/Dart process information, retrieve version details, and monitor various event streams for debugging Flutter applications.

  • Connects to a Flutter app's debug mode to extract data about widget trees, render trees, layer trees, and semantics, enabling AI tools to provide context-aware assistance for Flutter app development.

AI を活用した開発のための Flutter Inspector MCP サーバー

GitHubリポジトリ

🔍 Flutter アプリを Cursor、Claude、Cline などの AI コーディング アシスタントに接続する強力な Model Context Protocol (MCP) サーバー。

⚠️ このプロジェクトは現在進行中であり、すべてのメソッド (主に Flutter Inspector 関連) がまだ実装されていません。

現在、Flutterは転送サーバーを介してMCPサーバーと連携しています。詳細はアーキテクチャをご覧ください。

その他のメソッドの一部はテストされていないため、動作しない可能性があります。慎重にご利用ください。Flutterアプリケーション、そしておそらくJasprに特化したものになるため、ほとんどのメソッドはMCPサーバーから削除される可能性があります。

⚠️ 警告 ⚠️

大量のトークンを使用する可能性があり、コンテキストをオーバーロードする可能性のあるデバッグメソッドは、「debug-tools」パラメータの下に配置されました。本番環境では、すべてのデバッグメソッドはデフォルトで無効化されています。

🚀 はじめに

🎯 エージェントが呼び出せるもの:

  • [リソース|ツール]エラー分析:アプリの正確かつ簡潔なエラーを取得します。コンソールメッセージよりも優れている点は、トレースされたウィジェットのリスト全体や重複した情報ではなく、エージェントに必要な情報だけを正確に取得できることです。エージェントがエラーを理解するのに最適です。
  • [リソース|ツール]スクリーンショット: アプリのスクリーンショットを取得します。Claudeでのみ動作します(未テスト)。CursorとClineはレスポンスで画像形式をサポートしていません。

実装されます:

  • [リソース|ツール]アプリ情報:画面サイズ、ピクセル比。エージェントがウィジェットを選択できるようになります。
  • ホットリロードとホットリスタート
  • [リソース|ツール]選択ツール: 現在のアイデア:
    1. Flutter Inspector でウィジェットの選択を有効にします。
    2. 論理ピクセル位置でウィジェットを選択します。
    3. 論理ピクセル位置に基づいて、Flutter アプリの構造に関する詳細情報を取得します。

研究においては:

  • 現在のルートを検査: 現在のナビゲーション状態を確認します
  • 拡張機能: Flutter Provider/Riverpod の状態: Provider/Riverpod インスタンスの状態を取得します。
  • 拡張子: Jaspr :?
  • 拡張機能: Jaspr プロバイダー: ?
  • 拡張機能: Flame :?

📚 利用可能なツール

ポートが指定されていない場合、すべてのツールはデフォルトでポート8181を使用します。特定のポート番号を指定することで、この設定を上書きできます。

TOOLS.mdで説明されているほとんどのツール

todo: 便利な方法についての詳細を追加する

🔧 トラブルシューティング

次の点を確認してください:

  1. 転送サーバーが実行中であることを確認します。
  2. ブラウザでDevtoolsを開きました。
  3. Flutter アプリ開発依存関係に MCP 拡張機能を追加し、Devtools で有効にします。
  4. 接続の問題
    • Flutterアプリがデバッグモードで実行されていることを確認する
    • Flutterアプリとインスペクターの両方でポートが一致していることを確認します
    • ポートが他のプロセスによって使用されていないか確認する
  5. AIツールが検査官を検出しない
    • 構成変更後にAIツールを再起動します
    • 構成JSON構文を確認する
    • ツールのログで接続エラーを確認します

🚧 Smithery の統合 🚧 (作業中)

Flutter Inspector は Smithery のレジストリに登録されており、標準化されたインターフェースを通じて他の AI ツールで検出および使用できるようになります。

統合アーキテクチャ

┌─────────────────┐ ┌──────────────┐ ┌──────────────┐ ┌─────────────────┐ ┌─────────────┐ │ │ │ │ │ │ │ │ │ │ │ Flutter App │<--->│ DevTools │<--->│ Forwarding │<--->│ MCP Server │<--->│ Smithery │ │ (Debug Mode) │ │ Extension │ │ Server │ │ (Registered) │ │ Registry │ │ │ │ │ │ │ │ │ │ │ └─────────────────┘ └──────────────┘ └──────────────┘ └─────────────────┘ └─────────────┘

🤝 貢献する

貢献を歓迎します!お気軽にGitHub リポジトリにプルリクエストを送信したり、問題を報告してください。

📖 詳細はこちら

📄 ライセンス

MIT - プロジェクトで自由にご利用ください!


Flutter および Dart は Google LLC の商標です。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AIコーディングアシスタント(Cline、Cursor、Claudeなど)にウィジェットツリー、ナビゲーション、レイアウトの問題を分析する機能を提供することで、Flutterアプリのデバッグをシンプルに実現するMCPサーバーです。仕組みについては、アーキテクチャをご覧ください。https ://github.com/Arenukvern/mcp_flutter/blob/main/ARCHITECTURE.md

  1. ⚠️ WARNING ⚠️
    1. 🚀 Getting Started
      1. 🎯 What Agent can call:
        1. Will be implemented:
        2. In research:
      2. 📚 Available Tools
        1. 🔧 Troubleshooting
          1. 🚧 Smithery Integration 🚧 (work in progress)
            1. Integration Architecture
          2. 🤝 Contributing
            1. 📖 Learn More
              1. 📄 License
                ID: qnu3f0fa20