Flutter Project Structure

by msi-shamim

343 downloads
Not rated
GitHub

About

An MCP server that makes Flutter/Dart codebases instantly understandable to AI agents. Instead of spending 60,000+ tokens exploring a project every session, the agent queries pre-analyzed context through 6 tools — reducing orientation costs by 90%. Built on the flutter_project_st

Details

Author
msi-shamim
Downloads
343
Categories
Other, Developer Tools

- get_architecture – Returns project type, layers, dependency graph, and entry points.
- get_file_purpose – Returns purpose and code metrics for a specific file.
- get_dependencies – Returns detected naming conventions and purpose distribution.
- get_conventions – Returns detected naming conventions and purpose distribution.
- get_todos – Returns structured TODO/FIXME index with optional severity filter.
- get_project_structure – Returns full project structure markdown or specific sections.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Flutter Project Structure
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add the package with dart pub add dev:flutter_project_structure, then invoke any of the six tools through an MCP client. No further configuration is documented.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "flutter project structure": {
            "flutter-project-structure": {
                "command": "dart",
                "args": [
                    "run",
                    "flutter_project_structure",
                    "mcp-server",
                    "--watch"
                ]
            }
        }
    }
}

McpServers

{
    "flutter-project-structure": {
        "command": "dart",
        "args": [
            "run",
            "flutter_project_structure",
            "mcp-server",
            "--watch"
        ]
    }
}

Prerequisites:

dart pub add dev:flutter_project_structure

Tools (6):

| Tool| Description|
|--------|--------|
| get_architecture | Returns project type (app/package/plugin/monorepo), architectural layers, layer dependency graph, and entry points |
| get_file_purpose | Returns the purpose (widget, model, service, bloc, etc.) and code metrics for any specific file |
| get_dependencies | Returns detected naming conventions — file suffixes, class suffixes, and file purpose distribution |
| get_conventions | Returns detected naming conventions — file suffixes, class suffixes, and file purpose distribution |
| get_todos | Returns structured TODO/FIXME index with line numbers. Optionally filter by severity |
| get_project_structure | Returns full project structure markdown — summary by default, or a specific section (tree, frameworks, architecture, metrics, etc.)|

Author: MSI Shamim
License: MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.