Ghost MCP Server

Claude などの LLM インターフェースを通じて Ghost CMS とやり取りするための Model Context Protocol (MCP) サーバーです。このサーバーは、JWT 認証と、投稿、ユーザー、メンバー、ティア、オファー、ニュースレターを管理するための豊富な MCP ツールセットを活用し、Ghost ブログへの安全かつ包括的なアクセスを提供します。

特徴

• @tryghost/admin-api による安全な Ghost 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"
        }
      }
    }
}

利用可能なリソース

この MCP サーバーでは、以下の Ghost CMS リソースを利用できます:

• 投稿: Ghost サイトで公開された記事とコンテンツ。

• ページ: 独立したページ（概要、ランディング、ピラーページ）— 投稿と同じフィールド（すべての SEO/ソーシャルメタデータを含む）。

• メンバー: サイトの登録ユーザーと購読者。

• ニュースレター: Ghost を介して管理・送信されるメールニュースレター。

• オファー: メンバー向けのプロモーションオファーと割引。

• 招待: 新しいユーザーやスタッフを Ghost サイトに招待するための招待状。

• ロール: Ghost 管理内のユーザーロールと権限。

• タグ: 投稿とコンテンツの整理用タグ。

• ティア: メンバー向けのサブスクリプションティアとプラン。

• ユーザー: 管理者ユーザーとスタッフアカウント。

• ウェブフック: 外部サービスへの自動イベント通知。

利用可能なツール

この MCP サーバーは、Model Context Protocol を介して Ghost CMS を管理するための包括的なツールセットを公開しています。各リソースは、通常、エンティティの閲覧、読み取り、作成、編集、削除を含む一連の操作を提供します。以下は、利用可能なツールの概要です:

投稿

• 投稿の閲覧: オプションのフィルター、ページネーション、並べ替えを使用して投稿を一覧表示します。

• 投稿の読み取り: ID またはスラッグで投稿を取得します。

• 投稿の追加: タイトル、コンテンツ、ステータスを指定して新しい投稿を作成します。

• 投稿の編集: ID で既存の投稿を更新します。

• 投稿の削除: ID で投稿を削除します。

ページ

• ページの閲覧: オプションのフィルター、ページネーション、並べ替えを使用してページを一覧表示します。

• ページの読み取り: ID またはスラッグで単一のページを取得します。

• ページの追加: 新しいページを作成します。

• ページの編集: ページを更新します。html/lexical を省略するとコンテンツは変更されないため、メタデータのみの編集が安全です。

• ページの削除: ページを削除します。

編集可能なフィールドには、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 が含まれます。

メンバー

• メンバーの閲覧: フィルターとページネーションを使用してメンバーを一覧表示します。

• メンバーの読み取り: ID またはメールアドレスでメンバーを取得します。

• メンバーの追加: 新しいメンバーを作成します。

• メンバーの編集: メンバーの詳細を更新します。

• メンバーの削除: メンバーを削除します。

ニュースレター

• ニュースレターの閲覧: ニュースレターを一覧表示します。

• ニュースレターの読み取り: ID でニュースレターを取得します。

• ニュースレターの追加: 新しいニュースレターを作成します。

• ニュースレターの編集: ニュースレターの詳細を更新します。

• ニュースレターの削除: ニュースレターを削除します。

オファー

• オファーの閲覧: オファーを一覧表示します。

• オファーの読み取り: ID でオファーを取得します。

• オファーの追加: 新しいオファーを作成します。

• オファーの編集: オファーの詳細を更新します。

• オファーの削除: オファーを削除します。

招待

• 招待の閲覧: 招待を一覧表示します。

• 招待の追加: 新しい招待を作成します。

• 招待の削除: 招待を削除します。

ロール

• ロールの閲覧: ロールを一覧表示します。

• ロールの読み取り: ID でロールを取得します。

タグ

• タグの閲覧: タグを一覧表示します。

• タグの読み取り: ID またはスラッグでタグを取得します。

• タグの追加: 新しいタグを作成します。

• タグの編集: タグの詳細を更新します。

• タグの削除: タグを削除します。

ティア

• ティアの閲覧: ティアを一覧表示します。

• ティアの読み取り: ID でティアを取得します。

• ティアの追加: 新しいティアを作成します。

• ティアの編集: ティアの詳細を更新します。

• ティアの削除: ティアを削除します。

ユーザー

• ユーザーの閲覧: ユーザーを一覧表示します。

• ユーザーの読み取り: ID またはスラッグでユーザーを取得します。

• ユーザーの編集: ユーザーの詳細を更新します。

• ユーザーの削除: ユーザーを削除します。

ウェブフック

• ウェブフックの閲覧: ウェブフックを一覧表示します。

• ウェブフックの追加: 新しいウェブフックを作成します。

• ウェブフックの削除: ウェブフックを削除します。

各ツールは MCP プロトコルを介してアクセスでき、互換性のあるクライアントから呼び出すことができます。詳細なパラメータスキーマと使用方法については、src/tools/ のソースコードを参照してください。

エラーハンドリング

Ghost MCP Server は、API 通信エラーや処理の問題を処理するために、カスタム GhostError 例外を使用します。これにより、トラブルシューティングに役立つ明確で説明的なエラーメッセージが保証されます。

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する

3. 変更をコミットする

4. プルリクエストを作成する

ライセンス

MIT