Ghost MCP Server

Un servidor del Model Context Protocol (MCP) para interactuar con Ghost CMS a través de interfaces LLM como Claude. Este servidor proporciona acceso seguro y completo a tu blog de Ghost, aprovechando la autenticación JWT y un amplio conjunto de herramientas MCP para gestionar publicaciones, usuarios, miembros, niveles, ofertas y boletines.

Características

• Solicitudes seguras a la API de administración de Ghost con @tryghost/admin-api

• Acceso integral a entidades, incluyendo publicaciones, usuarios, miembros, niveles, ofertas y boletines

• Funcionalidad de búsqueda avanzada con opciones de coincidencia difusa y exacta

• Salida detallada y legible para entidades de Ghost

• Manejo robusto de errores mediante excepciones personalizadas GhostError

• Soporte de registro integrado a través del contexto MCP para una resolución de problemas mejorada

Uso

Para usar esto con clientes MCP, por ejemplo, Claude Desktop, añade lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
      "ghost-mcp": {
        "command": "npx",
        "args": ["-y", "@fanyangmeng/ghost-mcp"],
        "env": {
            "GHOST_API_URL": "https://yourblog.com",
            "GHOST_ADMIN_API_KEY": "your_admin_api_key",
            "GHOST_API_VERSION": "v5.0"
        }
      }
    }
}

Recursos Disponibles

Los siguientes recursos de Ghost CMS están disponibles a través de este servidor MCP:

• Publicaciones: Artículos y contenido publicado en tu sitio de Ghost.

• Páginas: Páginas independientes (acerca de, aterrizaje, pilares) — mismos campos que las publicaciones, incluyendo todos los metadatos SEO/sociales.

• Miembros: Usuarios registrados y suscriptores de tu sitio.

• Boletines: Boletines de correo electrónico gestionados y enviados a través de Ghost.

• Ofertas: Ofertas promocionales y descuentos para miembros.

• Invitaciones: Invitaciones para que nuevos usuarios o personal se unan a tu sitio de Ghost.

• Roles: Roles de usuario y permisos dentro del administrador de Ghost.

• Etiquetas: Etiquetas organizativas para publicaciones y contenido.

• Niveles: Niveles de suscripción y planes para miembros.

• Usuarios: Usuarios administradores y cuentas de personal.

• Webhooks: Notificaciones automáticas de eventos a servicios externos.

Herramientas Disponibles

Este servidor MCP expone un conjunto completo de herramientas para gestionar tu Ghost CMS a través del Model Context Protocol. Cada recurso proporciona un conjunto de operaciones, que típicamente incluyen navegar, leer, crear, editar y eliminar entidades. A continuación se muestra un resumen de las herramientas disponibles:

Publicaciones

• Navegar Publicaciones: Listar publicaciones con filtros opcionales, paginación y ordenación.

• Leer Publicación: Recuperar una publicación por ID o slug.

• Añadir Publicación: Crear una nueva publicación con título, contenido y estado.

• Editar Publicación: Actualizar una publicación existente por ID.

• Eliminar Publicación: Eliminar una publicación por ID.

Páginas

• Navegar Páginas: Listar páginas con filtros opcionales, paginación y ordenación.

• Leer Página: Recuperar una sola página por id o slug.

• Añadir Página: Crear una nueva página.

• Editar Página: Actualizar una página. Omitir html/lexical deja el contenido sin tocar, lo que hace que las ediciones solo de metadatos sean seguras.

• Eliminar Página: Eliminar una página.

Los campos editables incluyen slug, status, visibility, featured, published_at, custom_excerpt, feature_image (+ _alt, _caption), show_title_and_feature_image, meta_title, meta_description, og_title, og_description, og_image, twitter_title, twitter_description, twitter_image, codeinjection_head, codeinjection_foot, canonical_url, tags y authors.

Miembros

• Navegar Miembros: Listar miembros con filtros y paginación.

• Leer Miembro: Recuperar un miembro por ID o correo electrónico.

• Añadir Miembro: Crear un nuevo miembro.

• Editar Miembro: Actualizar los detalles del miembro.

• Eliminar Miembro: Eliminar un miembro.

Boletines

• Navegar Boletines: Listar boletines.

• Leer Boletín: Recuperar un boletín por ID.

• Añadir Boletín: Crear un nuevo boletín.

• Editar Boletín: Actualizar los detalles del boletín.

• Eliminar Boletín: Eliminar un boletín.

Ofertas

• Navegar Ofertas: Listar ofertas.

• Leer Oferta: Recuperar una oferta por ID.

• Añadir Oferta: Crear una nueva oferta.

• Editar Oferta: Actualizar los detalles de la oferta.

• Eliminar Oferta: Eliminar una oferta.

Invitaciones

• Navegar Invitaciones: Listar invitaciones.

• Añadir Invitación: Crear una nueva invitación.

• Eliminar Invitación: Eliminar una invitación.

Roles

• Navegar Roles: Listar roles.

• Leer Rol: Recuperar un rol por ID.

Etiquetas

• Navegar Etiquetas: Listar etiquetas.

• Leer Etiqueta: Recuperar una etiqueta por ID o slug.

• Añadir Etiqueta: Crear una nueva etiqueta.

• Editar Etiqueta: Actualizar los detalles de la etiqueta.

• Eliminar Etiqueta: Eliminar una etiqueta.

Niveles

• Navegar Niveles: Listar niveles.

• Leer Nivel: Recuperar un nivel por ID.

• Añadir Nivel: Crear un nuevo nivel.

• Editar Nivel: Actualizar los detalles del nivel.

• Eliminar Nivel: Eliminar un nivel.

Usuarios

• Navegar Usuarios: Listar usuarios.

• Leer Usuario: Recuperar un usuario por ID o slug.

• Editar Usuario: Actualizar los detalles del usuario.

• Eliminar Usuario: Eliminar un usuario.

Webhooks

• Navegar Webhooks: Listar webhooks.

• Añadir Webhook: Crear un nuevo webhook.

• Eliminar Webhook: Eliminar un webhook.

Cada herramienta es accesible a través del protocolo MCP y puede ser invocada desde clientes compatibles. Para esquemas de parámetros detallados y uso, consulta el código fuente en src/tools/.

Manejo de Errores

Ghost MCP Server emplea una excepción personalizada GhostError para manejar errores de comunicación con la API y problemas de procesamiento. Esto asegura mensajes de error claros y descriptivos para ayudar en la resolución de problemas.

Contribuciones

1. Haz un fork del repositorio

2. Crea una rama de características

3. Realiza los cambios

4. Crea una solicitud de extracción

Licencia

MIT