Ghost CMS

Automatize o Ghost CMS com operações CRUD completas, ações em massa e recursos avançados.

Documentação

Ghost CMS MCP Server

NPM Version License Node.js Version TypeScript CI Status

Um servidor abrangente de Model Context Protocol (MCP) para Ghost CMS que fornece capacidades completas de automação para blogs Ghost por meio de assistentes de IA como Claude Desktop, Cursor e outros clientes compatíveis com MCP.

Desenvolvido por Sivasubramanian Ramanathan | hello@sivasub.com
Product Owner | Catalisador de Inovação | Líder em FinTech anteriormente no Bank for International Settlements Innovation Hub, Singapura

Este projeto demonstra inovação técnica e habilidades de pensamento de produto, preenchendo a lacuna entre tecnologia complexa (Model Context Protocol) e aplicações práticas de negócios (automação de gerenciamento de conteúdo). Construído como uma vitrine de capacidades multifuncionais em desenvolvimento de produto, da concepção à entrega.

✨ Principais Recursos

  • 🚀 Integração Completa com Ghost CMS - Operações CRUD completas para posts, páginas, membros e muito mais
  • 🔐 Segurança Empresarial - Autenticação JWT com tratamento de erros e validação adequados
  • ⚡ Desempenho Inteligente - Limitação de taxa, cache e gerenciamento de fila integrados
  • 🎯 Operações em Lote - Atualizações eficientes de conteúdo em massa e gerenciamento de membros
  • 📊 Pronto para Produção - Testes abrangentes, pipeline de CI/CD e distribuição via NPM
  • 🤖 Design Focado em IA - Integração nativa com Claude, Cursor e ferramentas compatíveis com MCP

📦 Instalação Rápida

Para Claude Desktop

macOS/Linux:

npm install -g ghost-cms-mcp-server

Adicione à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "ghost-cms": {
      "command": "npx",
      "args": ["-y", "ghost-cms-mcp-server"],
      "env": {
        "GHOST_URL": "https://your-site.ghost.io",
        "GHOST_ADMIN_API_KEY": "your-admin-key",
        "GHOST_CONTENT_API_KEY": "your-content-key"
      }
    }
  }
}

Windows (PowerShell):

npm install -g ghost-cms-mcp-server
# Add similar configuration to %APPDATA%\Claude\claude_desktop_config.json

Para Claude Code CLI

claude mcp add ghost-cms -- npx -y ghost-cms-mcp-server

⚙️ Configuração

Variáveis de Ambiente Necessárias

GHOST_URL=https://your-site.ghost.io
GHOST_ADMIN_API_KEY=your-admin-key-id:your-admin-secret
GHOST_CONTENT_API_KEY=your-content-api-key

Obtendo Suas Chaves de API do Ghost

  1. Acesse o painel administrativo do Ghost → Integrations
  2. Clique em Add custom integration
  3. Copie a Admin API Key (formato: id:secret)
  4. Copie a Content API Key
  5. Use a URL do seu site Ghost

🛠️ Operações Disponíveis

Gerenciamento de Conteúdo

  • Posts: Criar, ler, atualizar, excluir, publicar, pesquisar, operações em lote
  • Páginas: Operações CRUD completas para páginas estáticas
  • Mídia: Enviar imagens e arquivos diretamente pela interface MCP

Gerenciamento de Público

  • Membros: Criar, atualizar, importar/exportar listas de assinantes
  • Tags: Organizar conteúdo com sistemas de marcação personalizados
  • Newsletters: Gerenciar campanhas de e-mail e segmentos de assinantes

Administração do Site

  • Configurações: Atualizar configurações e preferências do site
  • Usuários: Gerenciar autores e contas de administrador
  • Níveis: Configurar opções de assinatura e adesão

Recursos Avançados

  • Operações em Lote: Atualizar ou excluir conteúdo em massa com confirmações de segurança
  • Pesquisa e Filtragem: Capacidades avançadas de consulta com a sintaxe de filtro do Ghost
  • Sincronização em Tempo Real: Atualizações imediatas com resolução de conflitos

📋 Exemplos de Uso

Criar um Post no Blog

// Through your AI assistant using the ghost_posts_create tool
{
  "title": "Product Strategy in FinTech Innovation",
  "html": "<p>Insights from working at the BIS Innovation Hub...</p>",
  "status": "published",
  "tags": ["fintech", "product-management", "innovation"],
  "meta_title": "FinTech Product Strategy Guide",
  "featured": true
}

Gerenciamento de Conteúdo em Lote

// Update multiple posts at once
{
  "filter": "status:draft+created_at:>2024-01-01",
  "data": {
    "status": "published",
    "tags": ["updated-content"]
  }
}

Gerenciamento de Membros

// Add new newsletter subscribers
{
  "email": "subscriber@example.com",
  "name": "New Subscriber",
  "labels": ["newsletter", "fintech-insights"],
  "subscribed": true
}

🧪 Implementação Técnica

Destaques da Arquitetura

  • TypeScript: Segurança total de tipos com modo estrito habilitado
  • Desenvolvimento Orientado a Testes: Suíte de testes Jest abrangente com cobertura >80%
  • Tratamento de Erros: Limites de erro adequados com mensagens detalhadas
  • Desempenho: Fila de requisições, limitação de taxa e cache inteligente
  • Segurança: Proteção de chaves de API e validação de entrada

Fluxo de Desenvolvimento

# Local development
git clone https://github.com/siva-sub/ghost-cms-mcp-server.git
cd ghost-cms-mcp-server
npm install
npm run dev

# Testing
npm test                 # Run all tests
npm run test:coverage    # Generate coverage reports
npm run lint            # Code quality checks

🎯 Vitrine de Inovação de Produto

Este projeto demonstra habilidades-chave de desenvolvimento de produto:

🔍 Identificação de Problemas: Reconheceu a lacuna entre as APIs poderosas do Ghost CMS e as capacidades dos assistentes de IA

🚀 Design da Solução: Criou uma ponte que torna o gerenciamento de conteúdo conversacional e intuitivo

⚖️ Trade-offs Técnicos: Equilibrou completude de recursos com considerações de desempenho e segurança

📊 Experiência do Usuário: Projetou interfaces de ferramentas intuitivas que funcionam naturalmente com fluxos de conversa de IA

🔄 Desenvolvimento Iterativo: Construído com modularidade para permitir rápida expansão e adaptação de recursos

👨‍💼 Sobre o Criador

Sivasubramanian Ramanathan é um Product Owner e Catalisador de Inovação, anteriormente no Bank for International Settlements Innovation Hub em Singapura, especializado em inovação em FinTech, pesquisa em CBDC e soluções de tecnologia regulatória.

Áreas de Foco Profissional:

  • Estratégia de Produto: Gerenciamento de produto de ponta a ponta, da concepção à entrega
  • Inovação em FinTech: Design de CBDC, finanças digitais e tecnologia regulatória
  • Gestão de Stakeholders: Coordenação com mais de 19 bancos centrais e autoridades regulatórias
  • Liderança Técnica: Unindo requisitos de negócios com implementação de engenharia

Certificações:

  • PMP® - Project Management Professional
  • PSM II - Professional Scrum Master II
  • PSPO II - Professional Scrum Product Owner II

Conecte-se:

Publicações Recentes:

  • Project Viridis: A Blueprint for Managing Climate-Related Financial Risk (BIS Innovation Hub, 2024)
  • GenAI in Action: Transforming Data Use in SupTech (Irving Fisher Committee, 2025)
  • Novel Approaches to Combat Money Laundering (OMFIF Sustainable Policy Institute, 2024)

📄 Licença

Licença MIT - sinta-se à vontade para usar este projeto como inspiração para suas próprias inovações técnicas.


Construído por um Product Owner que codifica – demonstrando a interseção entre estratégia de negócios e execução técnica.

⭐ Dê uma estrela neste repositório para mostrar seu apoio ao desenvolvimento orientado por produto!