Ghost MCP

Um servidor MCP para a plataforma de blogs Ghost com suporte a Server-Sent Events (SSE).

Documentação

Ghost MCP Server

Servidor MCP (Model Context Protocol) para integração com o blog Ghost CMS. Permite que agentes de IA e LLMs gerenciem o conteúdo do blog Ghost por meio de ferramentas MCP padronizadas.

Estrutura de Diretórios

.
├── 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

Ferramentas Disponíveis

Ferramenta	Descrição
`create_ghost_post`	Criar uma nova postagem de blog
`list_ghost_posts`	Listar postagens com paginação
`update_ghost_post`	Atualizar uma postagem existente
`delete_ghost_post`	Excluir uma postagem
`create_ghost_page`	Criar uma nova página
`list_ghost_pages`	Listar páginas com paginação
`update_ghost_page`	Atualizar uma página existente
`delete_ghost_page`	Excluir uma página
`create_ghost_tag`	Criar uma nova tag
`update_ghost_tag`	Atualizar uma tag existente

Variáveis de Ambiente

Variável	Descrição	Obrigatório
`GHOST_API_URL`	URL da instância Ghost	Sim
`GHOST_ADMIN_KEY`	Chave da API de administração (formato: `id:secret`)	Sim
`PORT`	Porta do servidor (padrão: 3064)	Não
`NODE_ENV`	Modo de ambiente	Não

Executando o 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 da API

POST /mcp - Endpoint de requisição MCP
GET /mcp - Endpoint de streaming SSE
DELETE /mcp - Encerramento de sessão
GET /health - Verificação de saúde

Licença

MIT