# Craft IT Asset Generator MCP Server

![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6)
![Google Gemini](https://img.shields.io/badge/Gemini-2.0-blue)

A powerful Model Context Protocol (MCP) server that leverages Google Gemini AI to generate stunning images and icons seamlessly within your development workflow.

## ✨ Features

- **Transform Ideas into Art** — Create professional-quality images and icons powered by Google Gemini AI
- **Effortless Generation** — Turn simple text prompts into stunning visuals with intuitive parameters
- **Seamless Integration** — Works natively with AI assistants via Model Context Protocol (MCP)
- **Complete Creative Control** — Fine-tune every aspect from style and color to dimensions and format

## 🛠️ Tools

- ### generate

The main tool for creating images with Gemini AI.

**Inputs:**
- `prompt` (String): Your image description
- `parameters` (Object, optional):
    - `primary_color` (String): Hex color code for the main color theme
    - `style_descriptor` (String): Visual style (e.g., "flat", "3D", "minimalist")
    - `secondary_color` (String, optional): Accent color
    - `mood` (String, optional): The emotional tone (e.g., "cheerful", "serious")
- `output_config` (Object, optional):
    - `format` (String): Image format ("png", "jpeg")
    - `width` (Number): Image width in pixels
    - `height` (Number): Image height in pixels

**Example:**

```json
{
  "name": "generate",
  "arguments": {
    "prompt": "A minimalist icon of a rocket ship",
    "parameters": {
      "primary_color": "#3498db",
      "style_descriptor": "flat"
    },
    "output_config": {
      "format": "png",
      "width": 256,
      "height": 256
    }
  }
}
```
## Configuration
### Getting an API Key
1. Visit the [Google AI Studio](https://aistudio.google.com) to generate your [Gemini API key](https://aistudio.google.com).
2. Specify the location of your project's asset folder.

### Usage with Claude Desktop

Add this to your `claude_desktop_config.json`:

### NPX

```json
{
  "mcpServers": {
    "craft-it": {
      "command": "npx",
      "args": [
        "-y",
        "@kinetixarts/server-craft-it",
        "--stdio"
      ],
      "env": {
        "GEMINI_API_KEY": "your_gemini_api_key",
        "CRAFT_IT_IMAGE_PATH": "your_projects_asset_folder_location"
      }
    }
  }
}
```

### Usage with VS Code

For quick installation, use the one-click installation buttons below...

[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-NPM-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=craft-it&inputs=%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22apiKey%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40kinetixarts%2Fserver-craft-it%22%2C%22--stdio%22%5D%2C%22env%22%3A%7B%22GEMINI_API_KEY%22%3A%22%24%7Binput%3Agemini_api_key%7D%22%7D%7D)


For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing `Ctrl + Shift + P` and typing `Preferences: Open User Settings (JSON)`.

Optionally, you can add it to a file called `.vscode/mcp.json` in your workspace. This will allow you to share the configuration with others.

> Note that the `mcp` key is not needed in the `.vscode/mcp.json` file.

#### NPX

```json
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "gemini_api_key",
        "description": "Gemini API Key",
        "password": true
      }
    ],
    "servers": {
      "craft-it": {
        "command": "npx",
        "args": ["-y", "@kinetixarts/server-craft-it", "--stdio"],
        "env": {
          "GEMINI_API_KEY": "${input:gemini_api_key}",
          "CRAFT_IT_IMAGE_PATH": "your_projects_asset_folder_location"
        }
      }
    }
  }
}
```



## 📄 License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.