# 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:
```bash
uv sync
```
## Running Locally
To run the MCP server locally for testing:
```bash
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`:
```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:
```json
{
"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]
