Metadata-Version: 2.4
Name: cleanbev-mcp
Version: 0.1.0
Summary: MCP server for cleanbev – clean unused Flutter assets via AI tools
Requires-Python: >=3.11
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# cleanbev-mcp

MCP server for [cleanbev](https://pub.dev/packages/cleanbev) — clean unused Flutter assets from any MCP-compatible AI tool.

## Requirements

- Dart SDK on PATH
- `dart pub global activate cleanbev`

## Install (VS Code / Cursor)

1. Install the [Cursor extension](https://marketplace.visualstudio.com/items?itemName=cursorai.cursor) for VS Code.
2. Add the following to your Cursor config:

```jsonc
"customTools": [
    {
        "name": "CleanBev",
        "description": "Clean unused Flutter assets with cleanbev.",
        "command": "dart pub global run cleanbev_mcp",
        "args": [],
        "icon": "https://raw.githubusercontent.com/clean-bev/cleanbev/main/assets/icon.png"
    }
]
```

## Usage

1. Open a Flutter project in VS Code.
2. Use the Cursor command palette (Cmd+Shift+P) and select "Run Custom Tool: CleanBev".
3. Follow the prompts to clean unused assets from your project.

## Troubleshooting

- If you encounter an error about the 'dart' executable not being found, ensure that the Dart SDK is installed and that the `dart` command is available in your system's PATH. You can verify this by running `dart --version` in your terminal. If it returns the Dart SDK version, then Dart is correctly installed and on PATH. If not, you may need to install the Dart SDK from [https://dart.dev/get-dart](https://dart.dev/get-dart) and add it to your PATH environment variable.

- If you have issues with the MCP server, check the terminal output for any error messages. Ensure that you have the latest version of `cleanbev_mcp` by running `dart pub global activate cleanbev_mcp` again.

- For any other issues, consider opening an issue on the [cleanbev GitHub repository](https://github.com/koukibadr/cleanbev-package)

## Contributing

Contributions to the MCP server are welcome! If you have ideas for improvements or want to report bugs, please open an issue or submit a pull request on the [cleanbev GitHub repository](https://github.com/koukibadr/cleanbev-package).
