Servidor Ghost MCP
‼️ Aviso importante: Migración de Python a TypeScript
He reescrito completamente el servidor Ghost MCP de Python a TypeScript en esta versión v0.1.0. Este importante cambio aporta varias ventajas:
- Instalación simplificada: ahora disponible como paquete NPM (@fanyangmeng/ghost-mcp)
- Confiabilidad mejorada: utiliza el cliente oficial @tryghost/admin-api en lugar de una implementación personalizada
- Mejor mantenibilidad: TypeScript proporciona seguridad de tipos y una mejor organización del código
- Configuración optimizada: configuración sencilla de variables de entorno
Cambios de última hora
- Las dependencias de Python ya no son necesarias
- El método de configuración ha cambiado (ahora se utilizan variables de entorno Node.js)
- La implementación de Docker se ha simplificado
- Proceso de instalación diferente (ahora usando NPM)
Consulta la documentación actualizada a continuación para obtener más información sobre la migración desde la versión de Python. Si tienes algún problema, no dudes en abrir una incidencia en GitHub.
Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Ghost CMS mediante interfaces LLM como Claude. Este servidor proporciona acceso seguro y completo a tu blog de Ghost, aprovechando la autenticación JWT y un completo conjunto de herramientas MCP para gestionar publicaciones, usuarios, miembros, niveles, ofertas y boletines informativos.
Características
- Solicitudes seguras de la API de administración de Ghost con
@tryghost/admin-api - Acceso integral a entidades que incluye publicaciones, usuarios, miembros, niveles, ofertas y boletines informativos.
- Funcionalidad de búsqueda avanzada con opciones de coincidencia exacta y aproximada
- Salida detallada y legible para humanos para entidades fantasma
- Manejo robusto de errores mediante excepciones
GhostError personalizadas - Soporte de registro integrado a través del contexto MCP para una mejor resolución de problemas
Uso
Para usar esto con clientes MCP, por ejemplo, Claude Desktop, agregue lo siguiente a su 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 publicados en su sitio Ghost.
- Miembros : Usuarios registrados y suscriptores de su sitio.
- Boletines informativos : boletines informativos por correo electrónico administrados y enviados a través de Ghost.
- Ofertas : Ofertas promocionales y descuentos para socios.
- Invitaciones : invitaciones para que nuevos usuarios o personal se unan a su sitio Ghost.
- Roles : roles y permisos de usuario 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 automatizadas de eventos a servicios externos.
Herramientas disponibles
Este servidor MCP ofrece un conjunto completo de herramientas para administrar su Ghost CMS mediante el Protocolo de Contexto de Modelo. Cada recurso proporciona un conjunto de operaciones, que suelen incluir la navegación, la lectura, la creación, la edición y la eliminación de entidades. A continuación, se presenta un resumen de las herramientas disponibles:
Publicaciones
- Explorar publicaciones : enumera publicaciones con filtros opcionales, paginación y ordenamiento.
- Leer publicación : recuperar una publicación por ID o slug.
- Agregar publicación : crea una nueva publicación con título, contenido y estado.
- Editar publicación : actualiza una publicación existente por ID.
- Eliminar publicación : elimina una publicación por ID.
Miembros
- Explorar miembros : lista de miembros con filtros y paginación.
- Leer miembro : recuperar un miembro por ID o correo electrónico.
- Agregar miembro : crea un nuevo miembro.
- Editar miembro : actualiza los detalles del miembro.
- Eliminar miembro : eliminar un miembro.
- Explorar boletines : lista de boletines.
- Leer boletín : recuperar un boletín por ID.
- Añadir boletín : crea un nuevo boletín.
- Editar boletín : actualizar los detalles del boletín.
- Eliminar boletín : eliminar un boletín.
Ofertas
- Explorar Ofertas : Listado de ofertas.
- Leer oferta : recuperar una oferta por ID.
- Agregar oferta : crea una nueva oferta.
- Editar oferta : actualizar los detalles de la oferta.
- Eliminar oferta : eliminar una oferta.
Invitaciones
- Explorar invitaciones : lista de invitaciones.
- Agregar invitación : crea una nueva invitación.
- Eliminar invitación : eliminar una invitación.
Roles
- Explorar roles : enumerar roles.
- Leer rol : recupera un rol por ID.
Etiquetas
- Explorar etiquetas : Lista de etiquetas.
- Leer etiqueta : recupera una etiqueta por ID o slug.
- Agregar etiqueta : crea una nueva etiqueta.
- Editar etiqueta : actualiza los detalles de la etiqueta.
- Eliminar etiqueta : eliminar una etiqueta.
Niveles
- Explorar niveles : lista de niveles.
- Leer nivel : recupera un nivel por ID.
- Agregar nivel : crea un nuevo nivel.
- Editar nivel : actualiza los detalles del nivel.
- Eliminar nivel : elimina un nivel.
Usuarios
- Explorar usuarios : lista de usuarios.
- Leer usuario : recupera un usuario por ID o slug.
- Editar usuario : actualiza los detalles del usuario.
- Eliminar usuario : eliminar un usuario.
Webhooks
- Explorar webhooks : enumerar webhooks.
- Agregar webhook : crea un nuevo webhook.
- Eliminar webhook : eliminar un webhook.
Cada herramienta es accesible mediante el protocolo MCP y puede invocarse desde clientes compatibles. Para obtener información detallada sobre los esquemas de parámetros y su uso, consulte el código fuente en src/tools/ .
Manejo de errores
El servidor Ghost MCP utiliza una excepción GhostError personalizada para gestionar errores de comunicación de la API y problemas de procesamiento. Esto garantiza mensajes de error claros y descriptivos que facilitan la resolución de problemas.
Contribuyendo
- Repositorio de bifurcaciones
- Crear rama de características
- Confirmar cambios
- Crear una solicitud de extracción
Licencia
Instituto Tecnológico de Massachusetts (MIT)