<div align="center">

# 🎨 Illustrator AI Assistant & MCP Control

**Bridge generative AI directly with Adobe Illustrator.**  
*Generate vector artwork, logos, and layouts directly from natural language prompts, or connect autonomous AI agents via the Model Context Protocol (MCP).*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Adobe Illustrator](https://img.shields.io/badge/Adobe%20Illustrator-CC%202021--2025-FF9A00?logo=adobeillustrator&logoColor=white)](https://www.adobe.com/products/illustrator.html)
[![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
[![React](https://img.shields.io/badge/Frontend-React%2018%20%2B%20Vite-61DAFB?logo=react&logoColor=black)](https://reactjs.org/)
[![Model Context Protocol](https://img.shields.io/badge/Protocol-MCP%20Stdio%20%2F%20WebSocket-7C3AED)](https://modelcontextprotocol.io/)

[Português](#-visão-geral-em-português) • [English](#-english-overview) • [Instalação / Installation](#-instalação-rápida-quick-start) • [Contribuir / Contributing](#-chamada-para-colaboração-community-call)

---

</div>

## 🇧🇷 Visão Geral (em Português)

O **Illustrator AI & MCP Control** é uma extensão profissional para o Adobe Illustrator que traz o poder da inteligência artificial generativa diretamente para o fluxo de trabalho vetorial:

- 💬 **AI Assistant Integrado**: Converse em linguagem natural direto no painel do Illustrator para desenhar ilustrações vetoriais, criar logos minimalistas, gerar padrões geométricos, recolorir seleções e organizar camadas em tempo real.
- ⚡ **Multi-Provedores de IA**: Conecte com **Google Gemini** (Gemini 2.5 Flash / Pro), **OpenAI** (GPT-4o), **Anthropic Claude** (Claude 3.5 Sonnet), **Groq** (Llama 3.3 70B ultra-rápido) ou **OpenRouter**.
- 🎨 **Interface 100% Nativa do Illustrator**: Desenvolvida com a paleta exata de cores da interface do Adobe Illustrator CC (`#535353`), sem barras de rolagem intrusivas e com integração perfeita à área de trabalho.
- 🔌 **Ponte MCP (Model Context Protocol)**: Permite que ferramentas e agentes de IA externos (como **Antigravity**, **Claude Desktop**, **Cursor** ou scripts Python) controlem o Illustrator autonomamente via WebSocket.
- 🔒 **Privacidade Total**: Nenhuma chave de API ou dado sai do seu computador. As configurações são salvas apenas localmente.

---

## 🇺🇸 English Overview

**Illustrator AI & MCP Control** is a hybrid CEP panel and Model Context Protocol server that bridges generative AI models directly into Adobe Illustrator:

- **Interactive In-Panel AI Chat**: Generate production-ready vector artwork, clean ExtendScript code, and automated layers from prompts inside Illustrator.
- **Top AI Providers Supported**: Native integrations for Google Gemini, OpenAI, Anthropic Claude, Groq, and OpenRouter.
- **Adobe-Native Dark UI**: Designed according to Adobe Spectrum / CC Medium Dark standards with invisible scrollbars and artboard awareness.
- **External MCP Server Bridge**: Run the bundled Python MCP server to give external AI assistants full programmatic control over Illustrator.
- **Zero Configuration Hassle**: Includes 1-click automated installers for Windows and macOS with pre-built extension bundles.

---

## 🚀 Instalação Rápida (Quick Start)

### Windows (1 Clique)
1. Baixe ou clone este repositório no seu computador:
   ```bash
   git clone https://github.com/Bieuulls/Illustrator-AI-MCP.git
   ```
2. Clique com o botão direito no arquivo **`install-windows.bat`** e selecione **"Executar como Administrador"**.
3. O instalador irá:
   - Ativar o modo desenvolvedor CEP no Registro do Windows (`PlayerDebugMode`).
   - Vincular a extensão diretamente ao diretório de extensões do Adobe Illustrator.
   - Configurar o ambiente Python para o servidor MCP (caso o Python esteja instalado).
4. Abra ou reinicie o **Adobe Illustrator** e acesse:
   **Janela > Extensões > MCP Control** (ou *Window > Extensions > MCP Control*).

### macOS
1. Abra o terminal na pasta do projeto:
   ```bash
   bash install-macos.sh
   ```
2. Abra ou reinicie o Adobe Illustrator e acesse **Window > Extensions > MCP Control**.

---

## 🔑 Configurando sua Chave de IA

Você pode configurar a chave da sua IA preferida de duas formas:

### Opção 1: Pela Interface do Painel
1. No painel **MCP Control**, clique no botão **"Configurar Chave"** (ou no ícone de engrenagem ⚙️ no canto superior direito).
2. Selecione sua IA favorita (**Google Gemini**, **OpenAI**, **Claude**, **Groq** ou **OpenRouter**).
3. Cole sua chave de API e clique em **Salvar Chave**.

### Opção 2: Via Arquivo Local (`api_keys.json`)
Renomeie o arquivo `api_keys.example.json` para `api_keys.json` na raiz e preencha a chave desejada:
```json
{
  "gemini": "AIzaSy...",
  "openai": "sk-proj-...",
  "claude": "sk-ant-...",
  "groq": "gsk_...",
  "openrouter": "sk-or-..."
}
```
O painel detectará e carregará as chaves automaticamente na inicialização!

---

## 🔌 Conexão MCP (Claude Desktop, Antigravity, Cursor)

Para usar com assistentes MCP externos, configure seu cliente adicionando o servidor ao seu arquivo `mcp_config.json`:

```json
{
  "mcpServers": {
    "illustrator": {
      "command": "python",
      "args": ["-B", "-m", "illustrator_mcp.server"],
      "env": {
        "WS_HOST": "127.0.0.1",
        "WS_PORT": "8081",
        "TIMEOUT": "30"
      }
    }
  }
}
```

Na aba **MCP Bridge** do painel dentro do Illustrator, o status ficará verde (`● Connected`) assim que o cliente MCP iniciar a ponte WebSocket!

---

## 🤝 Chamada para Colaboração (Community Call)

> [!TIP]
> **Este é um projeto de código aberto feito para e pela comunidade!**  
> Toda ajuda é bem-vinda: seja você um designer testando prompts, um desenvolvedor criando novas ferramentas ou alguém reportando compatibilidade em versões específicas do Illustrator.

### Como você pode ajudar a melhorar o projeto?
- 🧪 **Testar Versões do Illustrator**: Validar o funcionamento em versões recentes (Illustrator 2022, 2023, 2024 e 2025) tanto no Windows quanto no macOS.
- 🎨 **Melhorar os Prompts de Geração**: Aprimorar o *system prompt* em `cep-extension/src/services/aiService.ts` para que a IA crie vetores ainda mais sofisticados (gradientes complexos, malhas, tipografia curvada, máscaras de recorte).
- 💻 **Suporte a Modelos Locais (Offline)**: Adicionar suporte para modelos rodando 100% locais via **Ollama**, **LM Studio** ou **LocalAI**.
- 🛠️ **Novas Ferramentas MCP**: Criar novos scripts ExtendScript para automatizar tarefas repetitivas (exportação em lote para SVG/PNG, preflight de arquivos, alinhamento inteligente).
- 🐛 **Reportar Bugs**: Encontrou algum erro? Abra uma [Issue](https://github.com/Bieuulls/Illustrator-AI-MCP/issues) detalhando o problema!

Consulte o nosso guia [CONTRIBUTING.md](CONTRIBUTING.md) para saber como rodar o ambiente de desenvolvimento e enviar seus Pull Requests.

---

## 📜 Créditos e Agradecimentos

- **Keda Jin** ([@jinkeda](https://github.com/jinkeda)): Autor original da arquitetura [Illustrator_MCP](https://github.com/jinkeda/Illustrator_MCP), do servidor Python WebSocket e do motor de execução via ExtendScript.
- Desenvolvido com apoio da comunidade open-source para levar IA generativa ao design gráfico vetorial profissional.

---

## 📄 Licença

Este projeto é distribuído sob a licença **MIT** - consulte o arquivo [LICENSE](LICENSE) para mais detalhes. Livre para uso pessoal, educacional e comercial.