Ghost MCP Server

Ghost MCP サーバー

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

機能

• @tryghost/admin-api を使用した安全な Ghost Admin API リクエスト
• 投稿、ユーザー、メンバー、ティア、オファー、ニュースレターを含む包括的なエンティティへのアクセス
• あいまい検索と完全一致検索の両方に対応した高度な検索機能
• Ghost エンティティの詳細で読みやすい出力
• カスタムの GhostError 例外を使用した堅牢なエラー処理
• トラブルシューティングを強化する、MCP コンテキスト経由の統合ログ機能

使用方法

Claude Desktop などの MCP クライアントで使用するには、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 サイトで公開されている記事とコンテンツです。
• メンバー：サイトに登録しているユーザーと購読者です。
• ニュースレター：Ghost で管理、配信されるメールニュースレターです。
• オファー：メンバー向けのプロモーションオファーと割引です。
• 招待：新しいユーザーやスタッフを Ghost サイトに招待するためのものです。
• ロール：Ghost 管理画面内のユーザーロールと権限です。
• タグ：投稿やコンテンツを整理するためのタグです。
• ティア：メンバー向けの購読ティアとプランです。
• ユーザー：管理者ユーザーとスタッフアカウントです。
• Webhook：外部サービスへの自動イベント通知です。

利用可能なツール

この MCP サーバーは、Model Context Protocol を通じて Ghost CMS を管理するための包括的なツールセットを公開します。各リソースには、通常、エンティティの一覧表示、読み取り、作成、編集、削除などの操作が用意されています。以下に、利用可能なツールの概要を示します。

投稿

• 投稿の一覧表示：任意のフィルター、ページネーション、並べ替えを指定して投稿を一覧表示します。
• 投稿の読み取り：ID またはスラッグで投稿を取得します。
• 投稿の追加：タイトル、コンテンツ、ステータスを指定して新しい投稿を作成します。
• 投稿の編集：ID で既存の投稿を更新します。
• 投稿の削除：ID で投稿を削除します。

メンバー

• メンバーの一覧表示：フィルターとページネーションを指定してメンバーを一覧表示します。
• メンバーの読み取り：ID またはメールアドレスでメンバーを取得します。
• メンバーの追加：新しいメンバーを作成します。
• メンバーの編集：メンバーの詳細を更新します。
• メンバーの削除：メンバーを削除します。

ニュースレター

• ニュースレターの一覧表示：ニュースレターを一覧表示します。
• ニュースレターの読み取り：ID でニュースレターを取得します。
• ニュースレターの追加：新しいニュースレターを作成します。
• ニュースレターの編集：ニュースレターの詳細を更新します。
• ニュースレターの削除：ニュースレターを削除します。

オファー

• オファーの一覧表示：オファーを一覧表示します。
• オファーの読み取り：ID でオファーを取得します。
• オファーの追加：新しいオファーを作成します。
• オファーの編集：オファーの詳細を更新します。
• オファーの削除：オファーを削除します。

招待

• 招待の一覧表示：招待を一覧表示します。
• 招待の追加：新しい招待を作成します。
• 招待の削除：招待を削除します。

ロール

• ロールの一覧表示：ロールを一覧表示します。
• ロールの読み取り：ID でロールを取得します。

タグ

• タグの一覧表示：タグを一覧表示します。
• タグの読み取り：ID またはスラッグでタグを取得します。
• タグの追加：新しいタグを作成します。
• タグの編集：タグの詳細を更新します。
• タグの削除：タグを削除します。

ティア

• ティアの一覧表示：ティアを一覧表示します。
• ティアの読み取り：ID でティアを取得します。
• ティアの追加：新しいティアを作成します。
• ティアの編集：ティアの詳細を更新します。
• ティアの削除：ティアを削除します。

ユーザー

• ユーザーの一覧表示：ユーザーを一覧表示します。
• ユーザーの読み取り：ID またはスラッグでユーザーを取得します。
• ユーザーの編集：ユーザーの詳細を更新します。
• ユーザーの削除：ユーザーを削除します。

Webhook

• Webhook の一覧表示：Webhook を一覧表示します。
• Webhook の追加：新しい Webhook を作成します。
• Webhook の削除：Webhook を削除します。

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

エラー処理

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

貢献

1. リポジトリをフォークします
2. フィーチャーブランチを作成します
3. 変更をコミットします
4. プルリクエストを作成します

ライセンス

MIT