Flutter Deprecations MCP Server

This MCP server tracks Flutter API deprecations and provides tools to check code for deprecated APIs and suggest replacements.

Project Structure

flutter-deprecations-server/
├── cmd/
│   └── server/          # Main application entry point
│       └── main.go
├── internal/            # Private application code
│   ├── handlers/        # MCP tool handlers
│   │   ├── mcp_handlers.go
│   │   ├── mcp_handlers_test.go
│   │   └── testdata/
│   ├── models/          # Data structures
│   │   └── flutter.go
│   └── services/        # Business logic
│       ├── cache.go
│       ├── cache_test.go
│       ├── deprecations.go
│       ├── deprecations_test.go
│       ├── flutter_api.go
│       ├── flutter_api_test.go
│       ├── flutter_version.go
│       ├── interfaces.go
│       ├── version_info.go
│       ├── version_info_test.go
│       └── testdata/
├── pkg/                 # Public libraries
│   └── config/          # Configuration constants
│       └── config.go
├── bin/                 # Compiled binaries
├── Makefile            # Build automation
├── go.mod              # Go module definition
├── go.sum              # Dependency checksums
└── README.md

Features

• Source-based deprecation tracking: Directly scans Flutter's GitHub source code for @Deprecated annotations
• Local caching: Stores deprecations locally with 24-hour cache duration
• Code analysis: Analyzes Flutter code snippets for deprecated APIs
• Replacement suggestions: Provides modern alternatives for deprecated APIs
• Comprehensive scanning: Scans key Flutter directories (widgets, material, cupertino, services, etc.)
• Version checking: Gets latest Flutter version using Flutter CLI (most reliable) with GitHub API fallback
• Multi-platform support: Checks FVM and Docker image availability
• Command-line cache management: Manual cache updates and clearing with progress reporting
• Short command options: Support for both long and short command flags
• Rate limit handling: Graceful handling of GitHub API rate limits with helpful error messages
• Verbose logging: Detailed logging with -vvv flag for troubleshooting

MCP Tools

1. check_flutter_deprecations

Analyzes provided Flutter code for deprecated APIs and suggests replacements.

Parameters:

• code (string): Flutter code snippet to analyze

Example:

Color.red.withOpacity(0.5)  // Will suggest Color.red.withValues(alpha: 0.5)

2. list_flutter_deprecations

Lists all known Flutter deprecations from the cache.

Parameters: None

Returns: Complete list of deprecations with replacements and version information.

3. check_flutter_version_info

Gets the latest stable Flutter version and checks availability across different tools and platforms.

Parameters: None

Returns:

• Latest stable Flutter version (using Flutter CLI when available, GitHub API fallback)
• Flutter CLI installation status and channel information
• FVM installation status and version availability
• Docker image availability for instrumentisto/flutter and ghcr.io/cirruslabs/flutter
• Usage examples and installation commands

Known Deprecations

The server includes built-in patterns for common deprecations:

• Color.withOpacity() → Color.withValues(alpha:)
• RaisedButton → ElevatedButton
• FlatButton → TextButton
• OutlineButton → OutlinedButton
• Scaffold.of(context).showSnackBar → ScaffoldMessenger.of(context).showSnackBar

Installation

Using Makefile (Recommended)

# Install dependencies
make deps

# Build the server
make build

# Run the server
make run

# Build for multiple platforms
make build-all

Manual Build

# Install dependencies
go mod tidy

# Build the server
go build -o bin/flutter-deprecations-server ./cmd/server

# Run the server
./bin/flutter-deprecations-server

# Update deprecations cache manually
./bin/flutter-deprecations-ser

... [View full README on GitHub](https://github.com/jger/mcp-flutter-deprecations-server#readme)