Ghost MCP Server

Interactúa con y gestiona tu blog de Ghost CMS, incluyendo publicaciones, usuarios y miembros, a través de una interfaz LLM.

GitHub
231

Documentación

Ghost MCP Server

Un servidor de 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 conjunto rico de herramientas MCP para gestionar publicaciones, usuarios, miembros, niveles, ofertas y boletines.

demo

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 usando excepciones personalizadas de GhostError
  • Soporte de registro integrado mediante contexto MCP para una resolución de problemas mejorada

Uso

Para usar esto con clientes MCP, por ejemplo, Claude Desktop, agrega 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 (Posts): Artículos y contenido publicado en tu sitio de Ghost.
  • Miembros (Members): Usuarios registrados y suscriptores de tu sitio.
  • Boletines (Newsletters): Boletines de correo electrónico gestionados y enviados mediante Ghost.
  • Ofertas (Offers): Ofertas promocionales y descuentos para miembros.
  • Invitaciones (Invites): Invitaciones para nuevos usuarios o personal para unirse a tu sitio de Ghost.
  • Roles: Roles de usuario y permisos dentro del administrador de Ghost.
  • Etiquetas (Tags): Etiquetas organizativas para publicaciones y contenido.
  • Niveles (Tiers): Niveles de suscripción y planes para miembros.
  • Usuarios (Users): 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 mediante el Model Context Protocol. Cada recurso proporciona un conjunto de operaciones, que generalmente incluyen navegar, leer, crear, editar y eliminar entidades. A continuación, se presenta 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.
  • Agregar 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.

Miembros

  • Navegar Miembros: Listar miembros con filtros y paginación.
  • Leer Miembro: Recuperar un miembro por ID o correo electrónico.
  • Agregar 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.
  • Agregar 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.
  • Agregar Oferta: Crear una nueva oferta.
  • Editar Oferta: Actualizar los detalles de la oferta.
  • Eliminar Oferta: Eliminar una oferta.

Invitaciones

  • Navegar Invitaciones: Listar invitaciones.
  • Agregar 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.
  • Agregar 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.
  • Agregar 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.
  • Agregar Webhook: Crear un nuevo webhook.
  • Eliminar Webhook: Eliminar un webhook.

Cada herramienta es accesible mediante el 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. Bifurcar el repositorio
  2. Crear una rama de características
  3. Realizar cambios y confirmarlos
  4. Crear una solicitud de extracción (pull request)

Licencia

MIT