@kinetixarts/craft-it-mcp-server v1.0.1

Craft-IT MCP Asset Generator

An MCP (Model Context Protocol) server for generating beautiful images and icons using Google Gemini AI.

🚀 Quick Start

# Run with npx (no installation needed)
npx @modelcontextprotocol/server-craft-it

# Or install globally
npm install -g @modelcontextprotocol/server-craft-it
server-craft-it

Required Environment Variables

Create a .env file in your current directory:

GEMINI_API_KEY=your_gemini_api_key_here

🌟 Features

• Generate high-quality images and icons with Gemini AI
• Simple text-to-image generation with customizable parameters
• MCP-compatible for AI assistant integration
• Control style, color, size, and format

💻 Usage Options

HTTP/SSE Mode (Default)

npx @modelcontextprotocol/server-craft-it

This starts the server with an SSE endpoint at http://localhost:3001/sse.

STDIO Mode (for direct integration)

npx @modelcontextprotocol/server-craft-it --stdio

This mode is ideal for direct integration with AI assistants.

Custom Port

PORT=8080 npx @modelcontextprotocol/server-craft-it

🔌 Client Integration

Connect any MCP-compatible client using the SSE URL:

{
  "mcpServers": {
    "craft-it": {
      "url": "http://localhost:3001/sse"
    }
  }
}

🛠️ API Interface

Use the generate tool to create images:

{
  "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
    }
  }
}

📄 License

MIT