👻 Ghost CMS 관리자 및 뉴스레터 MCP 서버

프로덕션 환경에 적합한 Model Context Protocol (MCP) 서버로, Streamable HTTP(MCP 사양), SSE, stdio를 지원하여 AI 모델(Claude, Cursor, Antigravity, ChatGPT, Cline, Zed 등)이 자체 호스팅 Ghost CMS 블로그 및 뉴스레터를 관리, 큐레이션, 초안 작성, 발행, 운영할 수 있게 해줍니다.

Ghost 인스턴스와 함께 VPS에서 독립 실행형으로 배포하도록 설계되었으며, Docker, Coolify, Caddy 또는 Nginx 뒤에서 실행할 수 있습니다.

⚡ Streamable HTTP 엔드포인트

Related MCP server: Ghost CMS MCP Server

🛠️ 포함된 MCP 도구 카탈로그

📝 1. 게시물 및 뉴스레터

• ghost_list_posts: 블로그 게시물 및 뉴스레터 발행본 검색, 필터링, 페이지네이션(draft, published, scheduled, sent, all).

• ghost_get_post: 전체 콘텐츠, HTML, mobiledoc/lexical, 태그, 작성자, 이메일 클릭/전달 통계 가져오기.

• ghost_create_post: Markdown 또는 HTML에서 SEO 메타데이터, 태그, 작성자, 발췌문, 사용자 지정 예약과 함께 블로그 게시물 및 뉴스레터 작성.

• ghost_update_post: 자동 동시성 동기화(updated_at)로 기존 게시물 편집.

• ghost_delete_post: ID로 게시물 영구 삭제.

• ghost_publish_and_send_newsletter: 구독 등급(all, status:free, status:paid)에 대한 원샷 발행 및 이메일 브로드캐스트.

📄 2. 정적 페이지

• ghost_list_pages, ghost_get_page, ghost_create_page, ghost_update_page, ghost_delete_page: 정적 페이지 전체 수명 주기(소개, 연락처, 랜딩 페이지).

💌 3. 뉴스레터 및 이메일 설정

• ghost_list_newsletters: 회원 수와 발송 내역이 포함된 모든 발행 이메일 뉴스레터 목록.

• ghost_get_newsletter, ghost_create_newsletter, ghost_update_newsletter: 발신자 이름, 발신자 이메일, 회신 주소, 구독자 기본값 관리.

👥 4. 회원 및 구독자

• ghost_list_members: 이메일, 이름, 구독 등급, 라벨로 구독자 검색 및 필터링.

• ghost_get_member, ghost_create_member, ghost_update_member, ghost_delete_member: 구독자 프로필 관리 및 무료 등급 할당.

• ghost_add_member_labels: 회원에게 세분화 라벨 추가.

🏷️ 5. 태그, 등급, 설정, 미디어 및 웹훅

• 태그: ghost_list_tags, ghost_get_tag, ghost_create_tag, ghost_update_tag, ghost_delete_tag(내부 #tags 포함).

• 등급 및 혜택: ghost_list_tiers, ghost_list_offers(무료 및 유료 멤버십, 가격, 쿠폰).

• 사이트 설정 및 진단: ghost_get_site_info, ghost_test_connection.

• 미디어 업로드: ghost_upload_image(로컬 파일, 웹 URL 또는 base64 이미지를 Ghost에 업로드하여 대표 이미지로 사용).

• 웹훅: ghost_list_webhooks, ghost_create_webhook, ghost_delete_webhook.

📦 MCP 리소스 및 프롬프트

리소스

• ghost://site/info – 발행물 제목, URL, 버전, 전역 설정.

• ghost://newsletters – 구독자 수가 포함된 활성 이메일 뉴스레터.

• ghost://tiers – 사용 가능한 멤버십 등급 및 가격 모델.

• ghost://posts/recent – 최근 발행된 게시물 10개.

• ghost://members/summary – 회원 수 및 최근 구독자 활동.

프롬프트

• draft-blog-post – 태그, 발췌문, 서식이 포함된 SEO 최적화 블로그 게시물 작성을 위한 안내형 대화형 템플릿.

• draft-newsletter – 브로드캐스트 준비가 된 매력적인 이메일 뉴스레터 호를 구성하고 작성.

• ghost-content-audit – 최근 게시물, 태그 위생, 잠재고객 성장 권장사항에 대한 완전한 편집 검토.

🔑 Ghost Admin API 설정

1. Ghost Admin 대시보드(https://your-blog.ghost.io/ghost 또는 http://localhost:2368/ghost)를 엽니다.

2. 설정(기어 아이콘) ➔ 통합(Integrations) 으로 이동합니다.

3. 사용자 지정 통합 추가를 클릭합니다.

4. 이름을 지정합니다(예: AI Admin Assistant 또는 MCP Server).

5. 다음을 복사합니다:

   • Admin API URL(예: http://localhost:2368 또는 https://blog.yourdomain.com)

   • Admin API Key(예: 64a7c8e2b0123456789abcde:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef)

🚀 Ghost와 함께하는 Coolify 및 VPS 배포

Coolify에 배포(무설정 리버스 프록시 및 SSL)

Coolify는 Traefik 리버스 프록시, Let's Encrypt SSL 인증서, Docker 네트워킹, 무중단 배포를 자동으로 처리합니다.

1. Git 저장소에서 Coolify에 새 리소스 생성.

2. 기본 디렉토리(Base Directory) 를 /ghost-admin-mcp로 설정(독립 저장소인 경우 루트).

3. 빌드 팩(Build Pack) 을 Dockerfile로, 포트(Port) 를 8765로 설정.

4. 환경 변수 구성:

   • GHOST_ADMIN_API_URL: https://blog.yourdomain.com

   • GHOST_ADMIN_API_KEY: <your-admin-api-key>

   • MCP_AUTH_TOKEN: <your-random-token>

   • PORT: 8765

   • TRANSPORT: streamable-http

5. 상태 확인 경로(Health Check Path) 를 /health로 설정.

6. 도메인 설정(예: https://mcp.yourdomain.com) — Coolify가 SSL을 자동 처리합니다!

Coolify의 멀티 컨테이너 Docker Compose는 COOLIFY.md를 참조하세요.

🔌 원격 AI 클라이언트 연결

Streamable HTTP(MCP 원격 클라이언트 / Cursor / Claude)

원격 클라이언트가 다음에 연결하도록 구성하세요:

• URL: https://mcp.yourdomain.com/mcp

• 헤더:

{
  "Authorization": "Bearer your_custom_secret_bearer_token"
}

로컬 Stdio(Claude Desktop / Cursor 로컬 폴백)

{
  "mcpServers": {
    "ghost-admin": {
      "command": "node",
      "args": ["/path/to/ghost-admin-mcp/dist/index.js"],
      "env": {
        "GHOST_ADMIN_API_URL": "https://blog.yourdomain.com",
        "GHOST_ADMIN_API_KEY": "your_key_id:your_secret_key"
      }
    }
  }
}

🧪 테스트

bun test

📄 라이선스

MIT