convez.ai
MCP ServerDesenvolvimento WebAvançado
k-dot-greyz

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 GitHub
InicialPluginScore · de 0 a 100

Servidor 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-tarot

1 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

Estrelas
2
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 2 semanas
Versão
—
Issues abertas
26
Contribuidores
3

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

DocPurpose
docs/SPEC.mdWhere the full v2.1 product spec lives (dev-master path + pointers)
docs/TESTING.mdTesting methodology — Vitest, Playwright, CI, commands
docs/TESTIDS.mddata-testid convention for RTL + E2E
docs/AETHER_RAM.ipynbAgent / session RAM + optional test run log cells

Scripts

ScriptDescription
npm run devDev server
npm run buildProduction bundle → build/
npm run previewServe build/
npm run lintESLint
npm run testVitest (coverage in CI)
npm run test:watchVitest watch
npm run test:e2ePlaywright E2E
npm run test:e2e:uiPlaywright 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.

Ver o original no GitHub

Bom para

Relacionados