Toolkits MCP

A stdio MCP implementation using Fast MCP 3 meant to be run locally. This MCP provides a collection of useful tools for image processing.

MCP Tools

• Image optimizer: Optimize images by reducing file size while maintaining quality.
• Remove background from image: Remove the background from images using AI.
• Favicon generator: Generate favicons of sizes 16, 32, 192, 512 from a logo.png file.

Tech Stack

• uv for Python environment management
• Python
• Fast MCP 3.0
• PIL (Pillow) for image processing
• rembg for background removal

Installation

1. Ensure you have uv installed. If not, install it from https://github.com/astral-sh/uv.

2. Clone or navigate to the project directory.

3. Install dependencies:

   uv sync
   

Running Locally

To run the MCP server locally for testing:

uv run python main.py

This starts the server using stdio transport, which is suitable for local development.

Using in VSCode

To use this MCP server in VSCode, you can integrate it with the Claude Code extension or GitHub Copilot Chat that supports MCP.

Option 1: Using Claude Code Extension

1. Install the "Claude Code" extension in VSCode from the marketplace.

2. Create a .mcp.json configuration file in your project root or user directory (e.g., ~/.mcp.json for user scope).

3. Add the following configuration to .mcp.json:

   {
     "mcpServers": {
       "toolkits-mcp": {
         "command": "uv",
         "args": ["run", "python", "main.py"],
         "cwd": "/path/to/toolkits-mcp"
       }
     }
   }
   

   Replace /path/to/toolkits-mcp with the actual path to your project directory.

4. Restart VSCode or reload the Claude Code extension.

5. The tools should now be available in Claude Code conversations.

Option 2: Using GitHub Copilot Chat

1. Ensure you have GitHub Copilot Chat installed in VSCode.

2. Open VSCode settings (Cmd/Ctrl + ,) and search for "mcp".

3. In the "GitHub Copilot Chat: Mcp" setting, add the server configuration:

   {
     "toolkits-mcp": {
       "command": "uv",
       "args": ["run", "python", "main.py"],
       "cwd": "/path/to/toolkits-mcp"
     }
   }
   

4. The tools will be available in Copilot Chat.

Usage

Once configured, you can use the tools in your AI assistant conversations:

• To optimize an image: Ask the assistant to optimize an image file.
• To remove background: Request background removal from an image.
• To generate favicons: Provide a logo.png and request favicon generation.

Development

To contribute or modify the tools:

1. Make changes to main.py.
2. Test locally using uv run python main.py.
3. Ensure all dependencies are listed in pyproject.toml.

License

[Add license information if applicable]