ゴーストMCPサーバー
‼️ 重要なお知らせ: Python から TypeScript への移行
このv0.1.0リリースでは、Ghost MCPサーバーをPythonからTypeScriptに完全に書き直しました。この大きな変更により、いくつかのメリットがもたらされます。
- インストールの簡素化: NPM パッケージとして利用可能になりました (@fanyangmeng/ghost-mcp)
- 信頼性の向上: カスタム実装の代わりに公式の @tryghost/admin-api クライアントを使用します
- 保守性の向上: TypeScript は型安全性と優れたコード構成を提供します
- 合理化された構成: シンプルな環境変数の設定
重大な変更
- Pythonの依存関係は不要になりました
- 設定方法が変更されました（Node.js 環境変数を使用するようになりました）
- Dockerの導入が簡素化されました
- 異なるインストールプロセス（現在はNPMを使用）
Pythonバージョンからの移行に関する詳細は、以下の更新されたドキュメントをご覧ください。問題が発生した場合は、GitHubで問題を報告してください。
ClaudeなどのLLMインターフェースを介してGhost CMSと連携するためのモデルコンテキストプロトコル（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 サイトで公開された記事とコンテンツ。
- メンバー: サイトの登録ユーザーおよび購読者。
- ニュースレター: Ghost 経由で管理および送信される電子メール ニュースレター。
- オファー: メンバー向けのプロモーション オファーと割引。
- 招待: Ghost サイトに参加するための新しいユーザーまたはスタッフの招待。
- 役割: Ghost 管理者内のユーザーの役割と権限。
- タグ: 投稿やコンテンツの整理タグ。
- 階層: メンバー向けのサブスクリプション階層とプラン。
- ユーザー: 管理者ユーザーとスタッフ アカウント。
- Webhooks : 外部サービスへの自動イベント通知。
利用可能なツール
このMCPサーバーは、モデルコンテキストプロトコル（MCP）を介してGhost CMSを管理するための包括的なツールセットを公開しています。各リソースは、通常、エンティティの参照、読み取り、作成、編集、削除など、一連の操作を提供します。利用可能なツールの概要は以下のとおりです。
投稿
- 投稿の参照: オプションのフィルター、ページ区切り、順序付けを使用して投稿を一覧表示します。
- 投稿を読む: ID またはスラッグで投稿を取得します。
- 投稿を追加: タイトル、内容、ステータスを指定して新しい投稿を作成します。
- 投稿を編集: ID で既存の投稿を更新します。
- 投稿を削除: ID で投稿を削除します。
メンバー
- メンバーの参照: フィルターとページ区切りを使用してメンバーを一覧表示します。
- メンバーの読み取り: ID またはメールでメンバーを取得します。
- メンバーの追加: 新しいメンバーを作成します。
- メンバー編集: メンバーの詳細を更新します。
- メンバーの削除: メンバーを削除します。
ニュースレター
- ニュースレターの閲覧: ニュースレターを一覧表示します。
- ニュースレターを読む: ID でニュースレターを取得します。
- ニュースレターを追加: 新しいニュースレターを作成します。
- ニュースレターの編集: ニュースレターの詳細を更新します。
- ニュースレターの削除: ニュースレターを削除します。
オファー
- オファーの閲覧: オファーを一覧表示します。
- オファーの読み取り: ID でオファーを取得します。
- オファーを追加: 新しいオファーを作成します。
- オファーの編集: オファーの詳細を更新します。
- オファーの削除: オファーを削除します。
招待
- 招待の参照: 招待を一覧表示します。
- 招待を追加: 新しい招待を作成します。
- 招待を削除: 招待を削除します。
役割
- ロールの参照: ロールを一覧表示します。
- ロールの読み取り: ID でロールを取得します。
タグ
- タグの参照: タグを一覧表示します。
- タグの読み取り: ID またはスラッグでタグを取得します。
- タグを追加: 新しいタグを作成します。
- タグの編集: タグの詳細を更新します。
- タグの削除: タグを削除します。
ティア
- ティアの参照: ティアを一覧表示します。
- ティアの読み取り: ID でティアを取得します。
- ティアの追加: 新しいティアを作成します。
- ティアの編集: ティアの詳細を更新します。
- ティアの削除: ティアを削除します。
ユーザー
- ユーザーの参照: ユーザーを一覧表示します。
- ユーザーの読み取り: ID またはスラッグでユーザーを取得します。
- ユーザーの編集: ユーザーの詳細を更新します。
- ユーザーの削除: ユーザーを削除します。
ウェブフック
- Webhook の参照: Webhook を一覧表示します。
- Webhook の追加: 新しい Webhook を作成します。
- Webhook の削除: Webhook を削除します。
各ツールはMCPプロトコルを介してアクセスでき、互換性のあるクライアントから呼び出すことができます。詳細なパラメータスキーマと使用方法については、 src/tools/のソースコードを参照してください。
エラー処理
Ghost MCP Serverは、API通信エラーや処理の問題を処理するために、カスタムGhostError例外を使用します。これにより、明確でわかりやすいエラーメッセージが提供されるため、トラブルシューティングに役立ちます。
貢献
- フォークリポジトリ
- 機能ブランチを作成する
- 変更をコミットする
- プルリクエストを作成する
ライセンス
マサチューセッツ工科大学