Modern EmDash CMS
EngDawood/modern-emdash-cms
CMS headless com MCP server e SSR em Workers para portfolios e sites dinâmicos
Ver no GitHubMCP server integrado a um portfólio bilíngue (árabe/inglês) construído com Astro SSR e EmDash CMS, rodando em Cloudflare Workers. Expõe 46 ferramentas para acesso via AI agents, com suporte a plugins sandboxados e gerenciamento de conteúdo em tempo real via D1.
Instalação
npx convez-ai EngDawood/modern-emdash-cms1 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
- Criar portfólios técnicos com CMS integrado e acesso por agentes IA
- Implantar sites multilingues em Cloudflare Workers com conteúdo dinâmico
- Expor APIs de conteúdo estruturado via MCP para automações e integrações
Veredito

Projeto maduro e bem estruturado que combina CMS headless com MCP server de forma prática. Ideal para quem quer sair do estático mas mantém simplicidade operacional em Workers, embora exija conhecimento sólido de Astro, Cloudflare e serverless.
README
A tradução para o português deste README ainda está na fila.
modern-emdash-cms
Personal portfolio built with Astro and EmDash CMS, deployed as a Cloudflare Worker. Bilingual Arabic/English, with a built-in MCP server for AI agent access to content.
Stack
| Layer | Technology |
|---|---|
| Framework | Astro SSR |
| CMS | EmDash (Cloudflare variant) |
| Runtime | Cloudflare Workers |
| Database | Cloudflare D1 |
| Media | Cloudflare R2 |
| Sessions | Cloudflare KV |
| Plugins | Worker Loaders (sandboxed, paid plan) |
| Cloudflare Email Routing | |
| UI | React + Vanilla CSS |
Features
- Bilingual i18n — Arabic (default, RTL) and English (LTR). Default locale served at
/, English at/en/... - EmDash CMS — All content lives in D1, managed via EmDash. Pages fetch at request time via
getEmDashCollection()/getEmDashEntry() - MCP server —
/mcpendpoint exposes 46 tools (36 EmDash content tools + 10 custom tools). Auth via?token=orAuthorization: Bearer - Sandboxed plugins — Marketplace plugins run in isolated Workers via the
LOADERbinding (paid plan) - Editorial design — Oxblood
#6b1438accent, bone#f8f5efbackground, Playfair Display + Amiri + Thmanyah typefaces
Branches
| Branch | Plan | Notes |
|---|---|---|
main | Paid | worker_loaders enabled, Cloudflare Email Routing |
free-emdash | Free | No worker_loaders in production, Resend email |
Local Development
pnpm install
# Create .dev.vars
echo 'EMDASH_TOKEN=your-token' > .dev.vars
# First-time DB setup
pnpm bootstrap
# Start dev server
pnpm dev # http://localhost:4321
Commands
pnpm dev # Dev server (Miniflare)
pnpm build # Production build
pnpm run deploy # Build + deploy to Cloudflare Workers
pnpm typecheck # Astro type check
pnpm bootstrap # Init EmDash DB schema + seed
Project Structure
src/
├── components/ # Astro + React components
├── pages/ # File-based routing
│ └── [locale]/ # Locale-prefixed routes
├── i18n/ # ar.json + en.json translation strings
├── layouts/ # Base.astro (root layout, fonts, nav)
├── mcp/ # MCP proxy (index.ts)
├── plugins/ # EmDash plugin entrypoints
├── live.config.ts # EmDash collection schema
└── worker.ts # Cloudflare Worker entry + PluginBridge
wrangler.jsonc # Dev config (includes worker_loaders)
wrangler.prod.jsonc # Production deploy config
MCP Server
# List available tools
curl -H "Authorization: Bearer $EMDASH_TOKEN" https://engdawood.com/mcp
The /mcp endpoint merges EmDash's built-in content tools with custom tools and forwards requests to the appropriate handler via env.SELF service binding.
Environment Variables
| Variable | Required | Description |
|---|---|---|
EMDASH_TOKEN | Yes | Bearer token for MCP auth |
EMDASH_URL | No | Override base URL (defaults to https://engdawood.com) |
JOBS_API_URL | No | External jobs Worker API base URL |
Deployment
pnpm run deploy
# Runs: pnpm exec wrangler deploy --config wrangler.prod.jsonc
Cloudflare Workers Builds dashboard deploy commands must include --config wrangler.prod.jsonc — omitting it causes the build to use wrangler.jsonc (which has worker_loaders) and fail with error 10195 on the free plan.