Metadata-Version: 2.4
Name: icogen-mcp
Version: 0.1.1
Summary: A Model Context Protocol (MCP) service for converting PNG files to ICO files with customizable icon dimensions
Author-email: icogen-mcp contributors <maintainer@example.com>
License: MIT
Project-URL: Homepage, https://github.com/username/icogen-mcp
Project-URL: Repository, https://github.com/username/icogen-mcp
Project-URL: Documentation, https://github.com/username/icogen-mcp/blob/main/README.md
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=9.0.0
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Dynamic: license-file

# icogen-mcp

A Model Context Protocol (MCP) service that enables AI assistants and other tools to convert PNG image files to Windows ICO icon files. The service provides a standardized interface for generating multi-resolution ICO files from PNG sources with customizable icon dimensions.

## Features

- Convert PNG files to multi-size ICO files with a single tool call
- Support for custom icon dimensions (defaults to 16x16, 32x32, 48x48, 64x64)
- Flexible output options - save to file or return binary data
- Built on the FastMCP framework for reliable MCP compliance
- Designed specifically for integration with AI assistants and automated workflows
- Utilizes Pillow for high-quality image processing

## Installation

```bash
pip install icogen-mcp
```

## Usage

This service is designed to work with MCP-compatible clients. Once integrated, you can use the `convert_png_to_ico` tool to convert PNG files to ICO format with customizable dimensions.

## Use Cases

- Icon generation for desktop applications
- Automated asset conversion in build pipelines
- AI-assisted graphic design workflows
- Integration with development tools and IDEs

## Dependencies

- Pillow: For image processing
- fastmcp: For MCP protocol implementation
- pydantic: For data validation

## Architecture

The service implements the Model Context Protocol specification and provides a single primary function:

- `convert_png_to_ico`: Converts a PNG file to an ICO file with customizable dimensions

The service leverages the Pillow library for high-quality image resizing and ICO format generation, supporting multiple resolutions within a single ICO file.

## License

MIT
