| Name | image-convertor-mcp JSON |
| Version |
0.1.7
JSON |
| download |
| home_page | None |
| Summary | Model Context Protocol Server for Image File Format Conversion |
| upload_time | 2025-08-21 07:31:52 |
| maintainer | Beta |
| docs_url | None |
| author | Beta |
| requires_python | >=3.9 |
| license | MIT License
Copyright (c) 2024 Beta
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE. |
| keywords |
gif
image-conversion
image-processing
mcp
model-context-protocol
pdf
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
mcp
Pillow
pillow-heif
reportlab
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Image Convertor MCP
A Model Context Protocol (MCP) server that provides comprehensive image conversion and processing tools.
## Features
- **General Image Conversion**: Convert between various image formats (JPEG, PNG, BMP, TIFF, ICO, WEBP, HEIC/HEIF, AVIF, GIF)
- **Batch Processing**: Convert entire folders of images to a target format
- **GIF Creation**: Convert multiple images to animated GIFs with customization options
- **PDF Generation**: Combine multiple images into a single PDF document
- **Smart Naming**: Automatic file naming with duplicate prevention
- **Format Detection**: Auto-detect input image formats
- **Quality Control**: Optimize ICO files with multiple resolutions
## Installation
### From PyPI
```bash
pip install image-convertor-mcp
```
### Development Installation
```bash
git clone https://github.com/beta/image-convertor-mcp
cd image-convertor-mcp
pip install -e .
```
## Configuration
No special configuration required. The server runs with default settings.
### Example MCP Configuration
```json
{
"mcpServers": {
"Image Convertor MCP": {
"command": "uvx",
"args": ["image-convertor-mcp"],
"env": {}
}
}
}
```
## Available Tools
### General Image Conversion
- `auto_convert_image(input_path:str, target_format:str, output_dir:str=None, file_name:str=None)` - Convert a single image to target format
- `auto_convert_folder(input_folder:str, target_format:str, output_dir:str=None)` - Convert all images in a folder to target format
### GIF Creation
- `convert_images_to_gif(input_folder:str, custom_name:str=None, duration:int=100, loop:int=0, color_mode:str="RGB", color_count:int=256, brightness:float=1.0, contrast:float=1.0, saturation:float=1.0, ping_pong:bool=False, easing:str="none", easing_strength:float=1.0)` - Convert multiple images to animated GIF
### PDF Generation
- `convert_images_to_pdf(input_folder:str, output_dir:str=None, output_name:str=None, sort_order:str="alphabetical", page_size:str="A4", dpi:int=300, fit_to_page:bool=True, center_image:bool=True, background_color:str="white")` - Combine multiple images into PDF
## Supported Formats
### Input Formats
- JPEG (.jpg, .jpeg)
- PNG (.png)
- BMP (.bmp)
- TIFF (.tif, .tiff)
- ICO (.ico)
- WEBP (.webp)
- HEIC/HEIF (.heic, .heif)
- AVIF (.avif)
- GIF (.gif)
### Output Formats
- JPEG (.jpg)
- PNG (.png)
- BMP (.bmp)
- TIFF (.tif)
- ICO (.ico)
- WEBP (.webp)
- HEIC/HEIF (.heic)
- AVIF (.avif)
- GIF (.gif)
- PDF (.pdf)
## Usage
### Command Line
```bash
image-convertor-mcp
```
### As MCP Server
The server runs over stdio and can be integrated with any MCP-compatible client.
## Requirements
- Python 3.9+
- Pillow (PIL) for image processing
- pillow-heif for HEIC/HEIF support
- reportlab for PDF generation
- Internet connection (for some format conversions)
## Changelog
### Version 0.1.7
- **Enhancement**: Improved error handling and user feedback for better MCP tool reliability
- **Performance**: Further optimized memory management and resource cleanup
- **Documentation**: Updated project metadata and PyPI package information
### Version 0.1.6
- **Bug Fix**: Fixed MCP server completion issue where tools would appear "stuck" in processing state
- **Bug Fix**: Fixed argument error in MCP tool execution that was preventing tools from running
- **Performance**: Optimized memory usage and resource management via garbage collection
- **Performance**: Added comprehensive warning capture and reporting for MCP tools with optional parameters
### Version 0.1.1
- Initial release with core image conversion functionality
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "image-convertor-mcp",
"maintainer": "Beta",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "gif, image-conversion, image-processing, mcp, model-context-protocol, pdf",
"author": "Beta",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/13/be/3cfa111686d0b8512f9acac3a9b8c8c7951c01d6d38c1a6e7a24ce630ef6/image_convertor_mcp-0.1.7.tar.gz",
"platform": null,
"description": "# Image Convertor MCP\n\nA Model Context Protocol (MCP) server that provides comprehensive image conversion and processing tools.\n\n## Features\n\n- **General Image Conversion**: Convert between various image formats (JPEG, PNG, BMP, TIFF, ICO, WEBP, HEIC/HEIF, AVIF, GIF)\n- **Batch Processing**: Convert entire folders of images to a target format\n- **GIF Creation**: Convert multiple images to animated GIFs with customization options\n- **PDF Generation**: Combine multiple images into a single PDF document\n- **Smart Naming**: Automatic file naming with duplicate prevention\n- **Format Detection**: Auto-detect input image formats\n- **Quality Control**: Optimize ICO files with multiple resolutions\n\n## Installation\n\n### From PyPI\n```bash\npip install image-convertor-mcp\n```\n\n### Development Installation\n```bash\ngit clone https://github.com/beta/image-convertor-mcp\ncd image-convertor-mcp\npip install -e .\n```\n\n## Configuration\n\nNo special configuration required. The server runs with default settings.\n\n### Example MCP Configuration\n\n```json\n{\n \"mcpServers\": {\n \"Image Convertor MCP\": {\n \"command\": \"uvx\",\n \"args\": [\"image-convertor-mcp\"],\n \"env\": {}\n }\n }\n}\n```\n\n## Available Tools\n\n### General Image Conversion\n- `auto_convert_image(input_path:str, target_format:str, output_dir:str=None, file_name:str=None)` - Convert a single image to target format\n- `auto_convert_folder(input_folder:str, target_format:str, output_dir:str=None)` - Convert all images in a folder to target format\n\n### GIF Creation\n- `convert_images_to_gif(input_folder:str, custom_name:str=None, duration:int=100, loop:int=0, color_mode:str=\"RGB\", color_count:int=256, brightness:float=1.0, contrast:float=1.0, saturation:float=1.0, ping_pong:bool=False, easing:str=\"none\", easing_strength:float=1.0)` - Convert multiple images to animated GIF\n\n### PDF Generation\n- `convert_images_to_pdf(input_folder:str, output_dir:str=None, output_name:str=None, sort_order:str=\"alphabetical\", page_size:str=\"A4\", dpi:int=300, fit_to_page:bool=True, center_image:bool=True, background_color:str=\"white\")` - Combine multiple images into PDF\n\n## Supported Formats\n\n### Input Formats\n- JPEG (.jpg, .jpeg)\n- PNG (.png)\n- BMP (.bmp)\n- TIFF (.tif, .tiff)\n- ICO (.ico)\n- WEBP (.webp)\n- HEIC/HEIF (.heic, .heif)\n- AVIF (.avif)\n- GIF (.gif)\n\n### Output Formats\n- JPEG (.jpg)\n- PNG (.png)\n- BMP (.bmp)\n- TIFF (.tif)\n- ICO (.ico)\n- WEBP (.webp)\n- HEIC/HEIF (.heic)\n- AVIF (.avif)\n- GIF (.gif)\n- PDF (.pdf)\n\n## Usage\n\n### Command Line\n```bash\nimage-convertor-mcp\n```\n\n### As MCP Server\nThe server runs over stdio and can be integrated with any MCP-compatible client.\n\n## Requirements\n\n- Python 3.9+\n- Pillow (PIL) for image processing\n- pillow-heif for HEIC/HEIF support\n- reportlab for PDF generation\n- Internet connection (for some format conversions)\n\n## Changelog\n\n### Version 0.1.7\n- **Enhancement**: Improved error handling and user feedback for better MCP tool reliability\n- **Performance**: Further optimized memory management and resource cleanup\n- **Documentation**: Updated project metadata and PyPI package information\n\n### Version 0.1.6\n- **Bug Fix**: Fixed MCP server completion issue where tools would appear \"stuck\" in processing state\n- **Bug Fix**: Fixed argument error in MCP tool execution that was preventing tools from running\n- **Performance**: Optimized memory usage and resource management via garbage collection\n- **Performance**: Added comprehensive warning capture and reporting for MCP tools with optional parameters\n\n### Version 0.1.1\n- Initial release with core image conversion functionality\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2024 Beta\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.",
"summary": "Model Context Protocol Server for Image File Format Conversion",
"version": "0.1.7",
"project_urls": {
"Documentation": "https://github.com/Beta0415/image-convertor-mcp#readme",
"Homepage": "https://github.com/Beta0415/image-convertor-mcp",
"Issues": "https://github.com/Beta0415/image-convertor-mcp/issues",
"Repository": "https://github.com/Beta0415/image-convertor-mcp"
},
"split_keywords": [
"gif",
" image-conversion",
" image-processing",
" mcp",
" model-context-protocol",
" pdf"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ac18470d942d3631579b0388bf80324615df946f805ff7d9e26a5cf7f2d80881",
"md5": "b325ccfe3473790c9d4e71281a3e5cc0",
"sha256": "5e050e4812d59257dc6038b246ceedfd407d7f4d9ccec4f83ac936b95aa90586"
},
"downloads": -1,
"filename": "image_convertor_mcp-0.1.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b325ccfe3473790c9d4e71281a3e5cc0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 21710,
"upload_time": "2025-08-21T07:31:51",
"upload_time_iso_8601": "2025-08-21T07:31:51.253892Z",
"url": "https://files.pythonhosted.org/packages/ac/18/470d942d3631579b0388bf80324615df946f805ff7d9e26a5cf7f2d80881/image_convertor_mcp-0.1.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "13be3cfa111686d0b8512f9acac3a9b8c8c7951c01d6d38c1a6e7a24ce630ef6",
"md5": "3f83964492749a781229996c07715ed5",
"sha256": "fef55ebea65024042d5fb55004de07c8c0fb0e63ab4a565ac7455db5d6caeb4a"
},
"downloads": -1,
"filename": "image_convertor_mcp-0.1.7.tar.gz",
"has_sig": false,
"md5_digest": "3f83964492749a781229996c07715ed5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 18068,
"upload_time": "2025-08-21T07:31:52",
"upload_time_iso_8601": "2025-08-21T07:31:52.334409Z",
"url": "https://files.pythonhosted.org/packages/13/be/3cfa111686d0b8512f9acac3a9b8c8c7951c01d6d38c1a6e7a24ce630ef6/image_convertor_mcp-0.1.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-21 07:31:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Beta0415",
"github_project": "image-convertor-mcp#readme",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "mcp",
"specs": [
[
">=",
"0.1.0"
]
]
},
{
"name": "Pillow",
"specs": [
[
">=",
"10.0.0"
]
]
},
{
"name": "pillow-heif",
"specs": [
[
">=",
"0.15.0"
]
]
},
{
"name": "reportlab",
"specs": [
[
">=",
"4.0.0"
]
]
}
],
"lcname": "image-convertor-mcp"
}
