Servidor MCP de Ghost

Un servidor del Protocolo de Contexto de Modelo (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 humanos de las entidades de Ghost

• Manejo robusto de errores utilizando excepciones personalizadas GhostError

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

Related MCP server: Ghost CMS MCP Server

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 (Posts): Artículos y contenido publicado en tu sitio Ghost.

• Miembros (Members): Usuarios registrados y suscriptores de tu sitio.

• Boletines (Newsletters): Boletines informativos por correo electrónico gestionados y enviados a través de Ghost.

• Ofertas (Offers): Ofertas promocionales y descuentos para miembros.

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

• Roles (Roles): Roles de usuario y permisos dentro de la administración 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 a través del Protocolo de Contexto de Modelo. 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 ordenamiento.

• 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.

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 de un 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 de un 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 una 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 una 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 de un 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 de un 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 obtener esquemas de parámetros detallados y uso, consulta el código fuente en src/tools/.

Manejo de errores

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

Contribución

1. Haz un fork del repositorio

2. Crea una rama de características

3. Confirma los cambios

4. Crea una solicitud de extracción (pull request)

Licencia

MIT