Ghost MCP Server

Сервер Model Context Protocol (MCP) для взаимодействия с Ghost CMS через LLM-интерфейсы, такие как Claude. Этот сервер обеспечивает безопасный и всесторонний доступ к вашему блогу Ghost, используя JWT-аутентификацию и богатый набор MCP-инструментов для управления постами, пользователями, участниками, тарифами, предложениями и рассылками.

Возможности

• Безопасные запросы к Ghost Admin API с помощью @tryghost/admin-api

• Всесторонний доступ к сущностям, включая посты, пользователей, участников, тарифы, предложения и рассылки

• Расширенный поиск с возможностями нечёткого и точного сопоставления

• Подробный, читаемый вывод для сущностей Ghost

• Надёжная обработка ошибок с использованием пользовательских исключений GhostError

• Встроенная поддержка логирования через контекст MCP для улучшенной диагностики

Использование

Чтобы использовать это с MCP-клиентами, например, с Claude Desktop, добавьте следующее в ваш 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"
        }
      }
    }
}

Доступные ресурсы

Следующие ресурсы Ghost CMS доступны через этот MCP-сервер:

• Posts: Статьи и контент, опубликованные на вашем сайте Ghost.

• Pages: Отдельные страницы (о нас, целевые, основные) — те же поля, что и у постов, включая все SEO/социальные метаданные.

• Members: Зарегистрированные пользователи и подписчики вашего сайта.

• Newsletters: Email-рассылки, управляемые и отправляемые через Ghost.

• Offers: Промо-предложения и скидки для участников.

• Invites: Приглашения для новых пользователей или сотрудников присоединиться к вашему сайту Ghost.

• Roles: Роли пользователей и разрешения в админке Ghost.

• Tags: Организационные теги для постов и контента.

• Tiers: Подписочные тарифы и планы для участников.

• Users: Администраторы и учётные записи сотрудников.

• Webhooks: Автоматические уведомления о событиях во внешние сервисы.

Доступные инструменты

Этот MCP-сервер предоставляет полный набор инструментов для управления вашим Ghost CMS через Model Context Protocol. Каждый ресурс предоставляет набор операций, обычно включающих просмотр, чтение, создание, редактирование и удаление сущностей. Ниже приведена сводка доступных инструментов:

Posts

• Browse Posts: Список постов с необязательными фильтрами, пагинацией и сортировкой.

• Read Post: Получить пост по ID или слагу.

• Add Post: Создать новый пост с заголовком, содержимым и статусом.

• Edit Post: Обновить существующий пост по ID.

• Delete Post: Удалить пост по ID.

Pages

• Browse Pages: Список страниц с необязательными фильтрами, пагинацией и сортировкой.

• Read Page: Получить отдельную страницу по ID или слагу.

• Add Page: Создать новую страницу.

• Edit Page: Обновить страницу. Если опустить html/lexical, содержимое останется нетронутым, что делает безопасным редактирование только метаданных.

• Delete Page: Удалить страницу.

Редактируемые поля включают slug, status, visibility, featured, published_at, custom_excerpt, feature_image (+ _alt, _caption), show_title_and_feature_image, meta_title, meta_description, og_title, og_description, og_image, twitter_title, twitter_description, twitter_image, codeinjection_head, codeinjection_foot, canonical_url, tags и authors.

Members

• Browse Members: Список участников с фильтрами и пагинацией.

• Read Member: Получить участника по ID или email.

• Add Member: Создать нового участника.

• Edit Member: Обновить данные участника.

• Delete Member: Удалить участника.

Newsletters

• Browse Newsletters: Список рассылок.

• Read Newsletter: Получить рассылку по ID.

• Add Newsletter: Создать новую рассылку.

• Edit Newsletter: Обновить данные рассылки.

• Delete Newsletter: Удалить рассылку.

Offers

• Browse Offers: Список предложений.

• Read Offer: Получить предложение по ID.

• Add Offer: Создать новое предложение.

• Edit Offer: Обновить данные предложения.

• Delete Offer: Удалить предложение.

Invites

• Browse Invites: Список приглашений.

• Add Invite: Создать новое приглашение.

• Delete Invite: Удалить приглашение.

Roles

• Browse Roles: Список ролей.

• Read Role: Получить роль по ID.

Tags

• Browse Tags: Список тегов.

• Read Tag: Получить тег по ID или слагу.

• Add Tag: Создать новый тег.

• Edit Tag: Обновить данные тега.

• Delete Tag: Удалить тег.

Tiers

• Browse Tiers: Список тарифов.

• Read Tier: Получить тариф по ID.

• Add Tier: Создать новый тариф.

• Edit Tier: Обновить данные тарифа.

• Delete Tier: Удалить тариф.

Users

• Browse Users: Список пользователей.

• Read User: Получить пользователя по ID или слагу.

• Edit User: Обновить данные пользователя.

• Delete User: Удалить пользователя.

Webhooks

• Browse Webhooks: Список вебхуков.

• Add Webhook: Создать новый вебхук.

• Delete Webhook: Удалить вебхук.

Каждый инструмент доступен через протокол MCP и может быть вызван из совместимых клиентов. Подробные схемы параметров и примеры использования см. в исходном коде в src/tools/.

Обработка ошибок

Ghost MCP Server использует пользовательское исключение GhostError для обработки ошибок связи с API и проблем обработки. Это обеспечивает понятные и подробные сообщения об ошибках для облегчения диагностики.

Вклад в проект

1. Сделайте форк репозитория

2. Создайте ветку функции

3. Зафиксируйте изменения

4. Создайте pull request

Лицензия

MIT