Ghost MCP Server

Interaja e gerencie seu blog Ghost CMS, incluindo posts, usuários e membros, por meio de uma interface LLM.

GitHub
231

Documentação

Ghost MCP Server

Um servidor Model Context Protocol (MCP) para interagir com o Ghost CMS por meio de interfaces LLM como o Claude. Este servidor fornece acesso seguro e abrangente ao seu blog Ghost, utilizando autenticação JWT e um rico conjunto de ferramentas MCP para gerenciar posts, usuários, membros, níveis, ofertas e newsletters.

demo

Recursos

  • Requisições seguras à API Admin do Ghost com @tryghost/admin-api
  • Acesso abrangente a entidades, incluindo posts, usuários, membros, níveis, ofertas e newsletters
  • Funcionalidade de busca avançada com opções de correspondência difusa e exata
  • Saída detalhada e legível para entidades do Ghost
  • Tratamento robusto de erros usando exceções personalizadas GhostError
  • Suporte integrado a logging via contexto MCP para solução de problemas aprimorada

Uso

Para usar com clientes MCP, por exemplo, o Claude Desktop, adicione o seguinte ao seu 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 Disponíveis

Os seguintes recursos do Ghost CMS estão disponíveis por meio deste servidor MCP:

  • Posts: Artigos e conteúdo publicados no seu site Ghost.
  • Membros: Usuários registrados e assinantes do seu site.
  • Newsletters: Newsletters por e-mail gerenciadas e enviadas via Ghost.
  • Ofertas: Ofertas promocionais e descontos para membros.
  • Convites: Convites para novos usuários ou equipe entrarem no seu site Ghost.
  • Funções: Funções de usuário e permissões dentro do admin do Ghost.
  • Tags: Tags organizacionais para posts e conteúdo.
  • Níveis: Níveis de assinatura e planos para membros.
  • Usuários: Usuários admin e contas de equipe.
  • Webhooks: Notificações automatizadas de eventos para serviços externos.

Ferramentas Disponíveis

Este servidor MCP expõe um conjunto abrangente de ferramentas para gerenciar seu Ghost CMS por meio do Model Context Protocol. Cada recurso fornece um conjunto de operações, normalmente incluindo navegação, leitura, criação, edição e exclusão de entidades. Abaixo está um resumo das ferramentas disponíveis:

Posts

  • Browse Posts: Listar posts com filtros opcionais, paginação e ordenação.
  • Read Post: Recuperar um post por ID ou slug.
  • Add Post: Criar um novo post com título, conteúdo e status.
  • Edit Post: Atualizar um post existente por ID.
  • Delete Post: Remover um post por ID.

Membros

  • Browse Members: Listar membros com filtros e paginação.
  • Read Member: Recuperar um membro por ID ou e-mail.
  • Add Member: Criar um novo membro.
  • Edit Member: Atualizar detalhes do membro.
  • Delete Member: Remover um membro.

Newsletters

  • Browse Newsletters: Listar newsletters.
  • Read Newsletter: Recuperar uma newsletter por ID.
  • Add Newsletter: Criar uma nova newsletter.
  • Edit Newsletter: Atualizar detalhes da newsletter.
  • Delete Newsletter: Remover uma newsletter.

Ofertas

  • Browse Offers: Listar ofertas.
  • Read Offer: Recuperar uma oferta por ID.
  • Add Offer: Criar uma nova oferta.
  • Edit Offer: Atualizar detalhes da oferta.
  • Delete Offer: Remover uma oferta.

Convites

  • Browse Invites: Listar convites.
  • Add Invite: Criar um novo convite.
  • Delete Invite: Remover um convite.

Funções

  • Browse Roles: Listar funções.
  • Read Role: Recuperar uma função por ID.

Tags

  • Browse Tags: Listar tags.
  • Read Tag: Recuperar uma tag por ID ou slug.
  • Add Tag: Criar uma nova tag.
  • Edit Tag: Atualizar detalhes da tag.
  • Delete Tag: Remover uma tag.

Níveis

  • Browse Tiers: Listar níveis.
  • Read Tier: Recuperar um nível por ID.
  • Add Tier: Criar um novo nível.
  • Edit Tier: Atualizar detalhes do nível.
  • Delete Tier: Remover um nível.

Usuários

  • Browse Users: Listar usuários.
  • Read User: Recuperar um usuário por ID ou slug.
  • Edit User: Atualizar detalhes do usuário.
  • Delete User: Remover um usuário.

Webhooks

  • Browse Webhooks: Listar webhooks.
  • Add Webhook: Criar um novo webhook.
  • Delete Webhook: Remover um webhook.

Cada ferramenta é acessível via protocolo MCP e pode ser invocada a partir de clientes compatíveis. Para esquemas de parâmetros detalhados e uso, consulte o código-fonte em src/tools/.

Tratamento de Erros

O Ghost MCP Server utiliza uma exceção personalizada GhostError para lidar com erros de comunicação com a API e problemas de processamento. Isso garante mensagens de erro claras e descritivas para auxiliar na solução de problemas.

Contribuindo

  1. Faça um fork do repositório
  2. Crie um branch de funcionalidade
  3. Faça commit das alterações
  4. Crie um pull request

Licença

MIT