👻 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: 静的ページの完全なライフサイクル（About、Contact、ランディングページ）。

💌 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（ローカルファイル、Web 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. 設定（歯車アイコン） ➔ インテグレーション に移動します。

3. カスタムインテグレーションを追加 をクリックします。

4. 名前を付けます（例：AI Admin Assistant または MCP Server）。

5. 以下をコピーします：

   • Admin API URL（例：http://localhost:2368 または https://blog.yourdomain.com）

   • Admin API キー（例：64a7c8e2b0123456789abcde:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef）

🚀 Ghost と並行した Coolify & VPS デプロイ

Coolify でのデプロイ（ゼロ設定リバースプロキシ & SSL）

Coolify は Traefik リバースプロキシ、Let's Encrypt SSL 証明書、Docker ネットワーキング、ゼロダウンタイムデプロイを自動的に処理します。

1. Git リポジトリから Coolify で新しいリソースを作成します。

2. ベースディレクトリを /ghost-admin-mcp に設定します（スタンドアロンリポジトリの場合はルート）。

3. ビルドパックを Dockerfile に、ポートを 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 に設定します。

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