Ghost MCP

Un servidor MCP para la plataforma de blogs Ghost con soporte para Server-Sent Events (SSE).

Documentación

Servidor Ghost MCP

Servidor MCP (Protocolo de Contexto de Modelo) para la integración con el blog de Ghost CMS. Permite que agentes de IA y LLMs gestionen el contenido del blog de Ghost a través de herramientas MCP estandarizadas.

Estructura de Directorios

.
├── index.js              # Main entry point
├── core/                 # Core server functionality
│   ├── server.js         # GhostServer class with API communication
│   └── api-client.js     # Shared Ghost API utilities and JWT auth
├── tools/                # MCP tool implementations
│   ├── index.js          # Tool registry and handlers
│   ├── ghost-tools.js    # Tool exports and definitions
│   ├── create-ghost-post.js
│   ├── list-ghost-posts.js
│   ├── update-ghost-post.js
│   ├── delete-ghost-post.js
│   ├── create-ghost-page.js
│   ├── list-ghost-pages.js
│   ├── update-ghost-page.js
│   ├── delete-ghost-page.js
│   ├── create-ghost-tag.js
│   └── update-ghost-tag.js
├── transports/           # Server transport implementations
│   ├── index.js          # Transport exports
│   ├── stdio-transport.js
│   ├── sse-transport.js
│   └── http-transport.js # Streamable HTTP (default)
└── __tests__/            # Test files

Herramientas Disponibles

HerramientaDescripción
create_ghost_postCrear una nueva publicación de blog
list_ghost_postsListar publicaciones con paginación
update_ghost_postActualizar una publicación existente
delete_ghost_postEliminar una publicación
create_ghost_pageCrear una nueva página
list_ghost_pagesListar páginas con paginación
update_ghost_pageActualizar una página existente
delete_ghost_pageEliminar una página
create_ghost_tagCrear una nueva etiqueta
update_ghost_tagActualizar una etiqueta existente

Variables de Entorno

VariableDescripciónRequerida
GHOST_API_URLURL de la instancia de GhostSí
GHOST_ADMIN_KEYClave de API de administración (formato: id:secret)Sí
PORTPuerto del servidor (predeterminado: 3064)No
NODE_ENVModo de entornoNo

Ejecutar el Servidor

# HTTP transport (default, for production)
npm start

# SSE transport
npm run start:sse

# Stdio transport (for CLI integration)
npm run start:stdio

# Development
npm run dev

# Run tests
npm test

Docker

# Build image
docker build -t ghost-mcp .

# Run container
docker run -p 3064:3064 \
  -e GHOST_API_URL=https://your-ghost-blog.com \
  -e GHOST_ADMIN_KEY=your-key-id:your-key-secret \
  ghost-mcp

Endpoints de API

  • POST /mcp - Endpoint de solicitudes MCP
  • GET /mcp - Endpoint de transmisión SSE
  • DELETE /mcp - Terminación de sesión
  • GET /health - Verificación de estado

Licencia

MIT