Glitchworks Tarot MCP Server
k-dot-greyz/glitchworks-tarot
Gerador de tarô glitch art com MCP, React 18 e CI/CD dev-master
Ver no GitHubServidor MCP para geração de cartas de tarô em estilo glitch art com modo escuro, integrado com Linear e Perplexity Labs. Oferece componentes React 18 (Dex, Arena, Oracle, Forge) para construir interfaces cyber-místicas com Tailwind CSS, incluindo pipeline CI/CD completo com testes Vitest e E2E Playwright.
Instalação
npx convez-ai k-dot-greyz/glitchworks-tarot1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Integrar geração de arte glitch dinamicamente em aplicações Claude
- Construir interfaces de tarô/oráculo com componentes reutilizáveis React
- Validar cards e spreads através de testes E2E em pipeline CI/CD
Veredito

Projeto bem estruturado com suporte MCP maduro, testes completos e documentação técnica clara. Ideal para quem quer integrar componentes React avançados em agents Claude, mas exige familiaridade com arquitetura React/Vite e ciclos CI/CD.
README
A tradução para o português deste README ainda está na fila.
glitchworks-tarot (Glitchworks — Aether Deck)
Dark-mode cyber-mystic card UI: Dex (library), Arena (clash), Oracle (spread), Forge (entity builder). React 18 + Vite + Tailwind + lucide-react.
Quick start (launch)
Requirements: Node 20.x, npm.
npm ci --legacy-peer-deps # install (peer deps: see note below)
npm run dev # http://localhost:5173 (Vite default)
Production-like local check:
npm run build && npm run preview # http://localhost:4173
Peer dependencies: this repo pins ESLint 10 while some plugins expect ESLint 9 — CI and local installs use npm ci --legacy-peer-deps. If npm install fails, use the same flag.
Documentation map
| Doc | Purpose |
|---|---|
docs/SPEC.md | Where the full v2.1 product spec lives (dev-master path + pointers) |
docs/TESTING.md | Testing methodology — Vitest, Playwright, CI, commands |
docs/TESTIDS.md | data-testid convention for RTL + E2E |
docs/AETHER_RAM.ipynb | Agent / session RAM + optional test run log cells |
Scripts
| Script | Description |
|---|---|
npm run dev | Dev server |
npm run build | Production bundle → build/ |
npm run preview | Serve build/ |
npm run lint | ESLint |
npm run test | Vitest (coverage in CI) |
npm run test:watch | Vitest watch |
npm run test:e2e | Playwright E2E |
npm run test:e2e:ui | Playwright UI |
CI
GitHub Actions: lint → Vitest + coverage → build → Playwright E2E (artifact-based). Deploy runs only on push to main / master (see .github/workflows/ci-cd.yml).
zenOS / dev-master
When embedded in dev-master, this repo lives at dex/09-repos/glitchworks-tarot. Cross-repo scratchpad: root AGENT_RAM.ipynb; app-specific notes: docs/AETHER_RAM.ipynb.
Deck spec v2.1 — see docs/SPEC.md for the canonical document location.