Ghost MCPサーバー

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

機能

• @tryghost/admin-api を使用した安全なGhost Admin APIリクエスト

• 投稿、ユーザー、メンバー、ティア、オファー、ニュースレターを含む包括的なエンティティアクセス

• あいまい検索と完全一致の両方に対応した高度な検索機能

• Ghostエンティティの詳細で人間が読みやすい出力

• カスタム GhostError 例外を使用した堅牢なエラーハンドリング

• トラブルシューティングを強化するためのMCPコンテキストを介した統合ログサポート

Related MCP server: Ghost CMS MCP Server

使用方法

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リソースを利用できます：

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

• メンバー (Members): サイトの登録ユーザーおよび購読者。

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

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

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

• ロール (Roles): Ghost管理画面内でのユーザーロールと権限。

• タグ (Tags): 投稿やコンテンツを整理するためのタグ。

• ティア (Tiers): メンバー向けのサブスクリプションティア（プラン）。

• ユーザー (Users): 管理者ユーザーおよびスタッフアカウント。

• Webhook: 外部サービスへの自動イベント通知。

利用可能なツール

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

投稿 (Posts)

• 投稿の閲覧: フィルタ、ページネーション、並び替えを指定して投稿を一覧表示します。

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

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

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

• 投稿の削除: IDを指定して投稿を削除します。

メンバー (Members)

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

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

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

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

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

ニュースレター (Newsletters)

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

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

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

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

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

オファー (Offers)

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

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

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

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

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

招待 (Invites)

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

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

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

ロール (Roles)

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

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

タグ (Tags)

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

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

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

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

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

ティア (Tiers)

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

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

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

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

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

ユーザー (Users)

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

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

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

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

Webhook

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

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

• Webhookの削除: Webhookを削除します。

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

エラーハンドリング

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

コントリビューション

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

2. フィーチャーブランチを作成する

3. 変更をコミットする

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

ライセンス

MIT