Ghost MCP Server

Ghost CMS와 상호작용하기 위한 Model Context Protocol (MCP) 서버로, Claude와 같은 LLM 인터페이스를 통해 사용할 수 있습니다. 이 서버는 JWT 인증과 posts, users, members, tiers, offers, newsletters를 관리하기 위한 풍부한 MCP 도구 세트를 활용하여 Ghost 블로그에 대한 안전하고 포괄적인 접근을 제공합니다.

Features

• @tryghost/admin-api를 사용한 안전한 Ghost Admin API 요청

• posts, users, members, tiers, offers, newsletters를 포함한 포괄적인 엔티티 접근

• 퍼지 및 정확 일치 옵션을 모두 지원하는 고급 검색 기능

• Ghost 엔티티에 대한 상세하고 사람이 읽기 쉬운 출력

• 사용자 정의 GhostError 예외를 사용한 견고한 오류 처리

• 향상된 문제 해결을 위한 MCP 컨텍스트를 통한 통합 로깅 지원

Usage

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"
        }
      }
    }
}

Available Resources

이 MCP 서버를 통해 다음 Ghost CMS 리소스를 사용할 수 있습니다:

• Posts: Ghost 사이트에 게시된 기사 및 콘텐츠.

• Pages: 독립형 페이지(소개, 랜딩, 필러 페이지) — 모든 SEO/소셜 메타데이터를 포함하여 posts와 동일한 필드를 가집니다.

• Members: 사이트의 등록 사용자 및 구독자.

• Newsletters: Ghost를 통해 관리되고 전송되는 이메일 뉴스레터.

• Offers: 멤버를 위한 프로모션 오퍼 및 할인.

• Invites: 새 사용자 또는 스태프를 Ghost 사이트에 초대하는 초대장.

• Roles: Ghost 관리자 내의 사용자 역할 및 권한.

• Tags: posts 및 콘텐츠를 위한 조직 태그.

• Tiers: 멤버를 위한 구독 티어 및 요금제.

• Users: 관리자 사용자 및 스태프 계정.

• Webhooks: 외부 서비스로의 자동 이벤트 알림.

Available Tools

이 MCP 서버는 Model Context Protocol을 통해 Ghost CMS를 관리하기 위한 포괄적인 도구 세트를 제공합니다. 각 리소스는 일반적으로 엔티티 탐색, 읽기, 생성, 편집, 삭제를 포함하는 일련의 작업을 제공합니다. 사용 가능한 도구에 대한 요약은 다음과 같습니다:

Posts

• Browse Posts: 선택적 필터, 페이지네이션, 정렬을 사용하여 posts를 나열합니다.

• Read Post: ID 또는 slug로 post를 검색합니다.

• Add Post: 제목, 콘텐츠, 상태로 새 post를 생성합니다.

• Edit Post: ID로 기존 post를 업데이트합니다.

• Delete Post: ID로 post를 삭제합니다.

Pages

• Browse Pages: 선택적 필터, 페이지네이션, 정렬을 사용하여 pages를 나열합니다.

• Read Page: id 또는 slug로 단일 page를 검색합니다.

• Add Page: 새 page를 생성합니다.

• Edit Page: page를 업데이트합니다. html/lexical을 생략하면 콘텐츠는 변경되지 않으므로 메타데이터만 편집해도 안전합니다.

• Delete Page: 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: 필터 및 페이지네이션으로 members를 나열합니다.

• Read Member: ID 또는 이메일로 member를 검색합니다.

• Add Member: 새 member를 생성합니다.

• Edit Member: member 세부 정보를 업데이트합니다.

• Delete Member: member를 삭제합니다.

Newsletters

• Browse Newsletters: newsletters를 나열합니다.

• Read Newsletter: ID로 newsletter를 검색합니다.

• Add Newsletter: 새 newsletter를 생성합니다.

• Edit Newsletter: newsletter 세부 정보를 업데이트합니다.

• Delete Newsletter: newsletter를 삭제합니다.

Offers

• Browse Offers: offers를 나열합니다.

• Read Offer: ID로 offer를 검색합니다.

• Add Offer: 새 offer를 생성합니다.

• Edit Offer: offer 세부 정보를 업데이트합니다.

• Delete Offer: offer를 삭제합니다.

Invites

• Browse Invites: invites를 나열합니다.

• Add Invite: 새 invite를 생성합니다.

• Delete Invite: invite를 삭제합니다.

Roles

• Browse Roles: roles를 나열합니다.

• Read Role: ID로 role을 검색합니다.

Tags

• Browse Tags: tags를 나열합니다.

• Read Tag: ID 또는 slug로 tag를 검색합니다.

• Add Tag: 새 tag를 생성합니다.

• Edit Tag: tag 세부 정보를 업데이트합니다.

• Delete Tag: tag를 삭제합니다.

Tiers

• Browse Tiers: tiers를 나열합니다.

• Read Tier: ID로 tier를 검색합니다.

• Add Tier: 새 tier를 생성합니다.

• Edit Tier: tier 세부 정보를 업데이트합니다.

• Delete Tier: tier를 삭제합니다.

Users

• Browse Users: users를 나열합니다.

• Read User: ID 또는 slug로 user를 검색합니다.

• Edit User: user 세부 정보를 업데이트합니다.

• Delete User: user를 삭제합니다.

Webhooks

• Browse Webhooks: webhooks를 나열합니다.

• Add Webhook: 새 webhook를 생성합니다.

• Delete Webhook: webhook를 삭제합니다.

각 도구는 MCP 프로토콜을 통해 접근할 수 있으며 호환되는 클라이언트에서 호출할 수 있습니다. 자세한 매개변수 스키마 및 사용법은 src/tools/의 소스 코드를 참조하세요.

Error Handling

Ghost MCP Server는 API 통신 오류 및 처리 문제를 처리하기 위해 사용자 정의 GhostError 예외를 사용합니다. 이를 통해 문제 해결에 도움이 되는 명확하고 설명적인 오류 메시지를 보장합니다.

Contributing

1. 저장소를 포크합니다.

2. 기능 브랜치를 생성합니다.

3. 변경 사항을 커밋합니다.

4. 풀 리퀘스트를 생성합니다.

License

MIT