👻 Servidor MCP para Administración y Newsletter de Ghost CMS

Un servidor Model Context Protocol (MCP) listo para producción que soporta HTTP Streamable (especificación MCP), SSE y stdio, permitiendo que modelos de IA (Claude, Cursor, Antigravity, ChatGPT, Cline, Zed, etc.) gestionen, seleccionen, redacten, publiquen y administren Blogs y Newsletters de Ghost CMS autoalojados.

Diseñado para implementación independiente en tu VPS junto a tu instancia de Ghost, detrás de Docker, Coolify, Caddy o Nginx.

⚡ Endpoints HTTP Streamable

Related MCP server: Ghost CMS MCP Server

🛠️ Catálogo de Herramientas MCP Incluidas

📝 1. Publicaciones y Newsletters

• ghost_list_posts: Buscar, filtrar y paginar publicaciones de blog y ediciones de newsletter (draft, published, scheduled, sent, all).

• ghost_get_post: Obtener contenido completo, HTML, mobiledoc/lexical, etiquetas, autores y estadísticas de clics/entrega de correos.

• ghost_create_post: Crear publicaciones de blog y newsletters directamente desde Markdown o HTML con metadatos SEO, etiquetas, autores, extractos y programación personalizada.

• ghost_update_post: Editar publicaciones existentes con sincronización automática de concurrencia (updated_at).

• ghost_delete_post: Eliminar permanentemente una publicación por ID.

• ghost_publish_and_send_newsletter: Publicación y envío de correo en un solo paso a niveles de suscriptores (all, status:free, status:paid).

📄 2. Páginas Estáticas

• ghost_list_pages, ghost_get_page, ghost_create_page, ghost_update_page, ghost_delete_page: Ciclo de vida completo de páginas estáticas (Acerca de, Contacto, Páginas de destino).

💌 3. Newsletters y Configuración de Correo

• ghost_list_newsletters: Listar todos los newsletters de correo de la publicación con recuento de miembros e historial de envíos.

• ghost_get_newsletter, ghost_create_newsletter, ghost_update_newsletter: Gestionar nombres de remitente, correos de remitente, responder a y valores predeterminados de suscriptores.

👥 4. Miembros y Suscriptores

• ghost_list_members: Buscar y filtrar suscriptores por correo electrónico, nombre, nivel de suscripción y etiquetas.

• ghost_get_member, ghost_create_member, ghost_update_member, ghost_delete_member: Gestión de perfiles de suscriptores y asignaciones de niveles complementarios.

• ghost_add_member_labels: Añadir etiquetas de segmentación a los miembros.

🏷️ 5. Etiquetas, Niveles, Configuración, Medios y Webhooks

• Etiquetas: ghost_list_tags, ghost_get_tag, ghost_create_tag, ghost_update_tag, ghost_delete_tag (incluyendo etiquetas internas #tags).

• Niveles y Ofertas: ghost_list_tiers, ghost_list_offers (Membresías gratuitas y de pago, precios, cupones).

• Configuración del sitio y Diagnóstico: ghost_get_site_info, ghost_test_connection.

• Carga de Medios: ghost_upload_image (subir archivos locales, URLs web o imágenes base64 a Ghost para imágenes destacadas).

• Webhooks: ghost_list_webhooks, ghost_create_webhook, ghost_delete_webhook.

📦 Recursos y Prompts de MCP

Recursos

• ghost://site/info – Título de la publicación, URL, versión y configuración global.

• ghost://newsletters – Newsletters de correo activos con recuento de suscriptores.

• ghost://tiers – Niveles de membresía disponibles y modelos de precios.

• ghost://posts/recent – Las 10 publicaciones más recientes.

• ghost://members/summary – Recuentos de miembros y actividades recientes de suscriptores.

Prompts

• draft-blog-post – Plantilla interactiva guiada para crear una publicación de blog optimizada para SEO con etiquetas, extractos y formato.

• draft-newsletter – Estructurar y redactar un número de newsletter atractivo listo para enviar.

• ghost-content-audit – Revisión editorial completa de publicaciones recientes, higiene de etiquetas y recomendaciones de crecimiento de audiencia.

🔑 Configuración de la API de Administración de Ghost

1. Abre tu panel de administración de Ghost (https://tu-blog.ghost.io/ghost o http://localhost:2368/ghost).

2. Ve a Configuración (icono de engranaje) ➔ Integraciones.

3. Haz clic en Añadir integración personalizada.

4. Ponle un nombre (por ejemplo, Asistente de Administración IA o Servidor MCP).

5. Copia:

   • URL de la API de Administración (por ejemplo, http://localhost:2368 o https://blog.tudominio.com)

   • Clave de la API de Administración (por ejemplo, 64a7c8e2b0123456789abcde:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef)

🚀 Implementación en Coolify y VPS junto a Ghost

Implementación en Coolify (Proxy Inverso y SSL sin Configuración)

Coolify maneja automáticamente el proxy inverso de Traefik, los certificados SSL de Let's Encrypt, la red de Docker y las implementaciones sin tiempo de inactividad.

1. Crear Nuevo Recurso en Coolify desde tu repositorio de Git.

2. Establece el Directorio Base a /ghost-admin-mcp (o raíz si es un repositorio independiente).

3. Establece el Paquete de Compilación a Dockerfile y el Puerto a 8765.

4. Configura las Variables de Entorno:

   • GHOST_ADMIN_API_URL: https://blog.tudominio.com

   • GHOST_ADMIN_API_KEY: <tu-clave-de-api-de-administración>

   • MCP_AUTH_TOKEN: <tu-token-aleatorio>

   • PORT: 8765

   • TRANSPORT: streamable-http

5. Establece la Ruta de Verificación de Salud a /health.

6. Establece tu dominio (por ejemplo, https://mcp.tudominio.com) — ¡Coolify maneja SSL automáticamente!

Para Docker Compose multi-contenedor en Coolify, consulta COOLIFY.md.

🔌 Conexión de Clientes de IA Remotos

HTTP Streamable (Cliente MCP Remoto / Cursor / Claude)

Configura tu cliente remoto para conectarse a:

• URL: https://mcp.tudominio.com/mcp

• Encabezados:

  {
    "Authorization": "Bearer your_custom_secret_bearer_token"
  }

Stdio Local (Claude Desktop / respaldo local de Cursor)

{
  "mcpServers": {
    "ghost-admin": {
      "command": "node",
      "args": ["/path/to/ghost-admin-mcp/dist/index.js"],
      "env": {
        "GHOST_ADMIN_API_URL": "https://blog.yourdomain.com",
        "GHOST_ADMIN_API_KEY": "your_key_id:your_secret_key"
      }
    }
  }
}

🧪 Pruebas

bun test

📄 Licencia

MIT