Ghost MCP

🚀 鬼魂 MCP サーバ

大型言語モデル (LLM) インターフェースを介して Ghost CMS とやり取りするための Model Context Protocol (MCP) サーバです。このサーバは、安全で包括的な Ghost ブログへのアクセスを提供し、JWT 認証と充実した MCP ツールセットを利用して、記事、ユーザー、メンバー、サブスクリプションレベル、特典、ニュースレターの管理をサポートします。

🚀 クイックスタート

鬼魂 MCP サーバは、大型言語モデル (LLM) インターフェースを通じて Ghost CMS とのやり取りを可能にする MCP サーバです。安全かつ包括的な Ghost ブログへのアクセスを提供し、JWT 認証と豊富な MCP ツールセットを利用して、記事やユーザーなどの管理をサポートします。

✨ 主な機能

• @tryghost/admin-api を使用して、安全に Ghost Admin API をリクエストします。
• 記事、ユーザー、メンバー、サブスクリプションレベル、特典、ニュースレターを含む、包括的なエンティティへのアクセス権を持ちます。
• 曖昧検索と完全一致検索オプションをサポートする高度な検索機能があります。
• 詳細で理解しやすいエンティティ出力を提供します。
• カスタムの GhostError 例外を使用してエラーを処理します。
• MCP コンテキストを介した統合ロギングサポートがあり、トラブルシューティングが容易です。

📦 インストール

💡 重要通知：Python から TypeScript への移行

私は Ghost MCP Server を完全に TypeScript で書き直し、v0.1.0 バージョンでリリースしました。この大きな変更により、以下の利点が得られます。

• インストールが簡素化：現在は NPM パッケージ（@fanyangmeng/ghost-mcp）として提供されます。
• 信頼性が向上：公式の @tryghost/admin-api クライアントを使用し、カスタム実装ではなくなりました。
• メンテナンスが容易：TypeScript が型安全とより良いコード組織を提供します。
• 設定が簡潔：Node.js 環境変数の設定のみで済みます。

大きな変更点

• Python 依存関係は不要になりました。
• 設定方法が変更されました（現在は Node.js 環境変数を使用）。
• Docker デプロイが簡素化されました。
• インストールプロセスが変更されました（現在は NPM を使用）。

Python バージョンからの移行方法については、以下の更新ドキュメントを参照してください。問題が発生した場合は、GitHub で issue を提出してください。

💻 使用例

基本的な使用法

この MCP サーバと連携するには、claude_desktop.yaml に以下の内容を追加してください。

ghost-mcp-server:
  enabled: true
  endpoint: http://localhost:5000

デフォルトのポートは 5000 です。詳細については 設定ファイル を参照してください。

📚 ドキュメント

設定

環境変数

サーバを実行するために必要な環境変数は以下の通りです。

ツール

記事管理

interface GhostArticleToolParams {
  title: string;
  content: string;
  authorId?: string;
  publishedAt?: string;
}

async function createGhostArticle(params: GhostArticleToolParams): Promise<void> {
  // 記事作成ロジック
}

async function updateGhostArticle(articleId: string, params: Omit<GhostArticleToolParams, 'title'>): Promise<void> {
  // 記事更新ロジック
}

async function deleteGhostArticle(articleId: string): Promise<void> {
  // 記事削除ロジック
}

ユーザー管理

interface GhostUserToolParams {
  email: string;
  password: string;
  username?: string;
}

async function createUser(params: GhostUserToolParams): Promise<string> {
  // ユーザー作成ロジック、ユーザー ID を返す
}

async function updateUser(userId: string, params: Omit<GhostUserToolParams, 'email'>): Promise<void> {
  // ユーザー更新ロジック
}

エラー処理

Ghost MCP Server は、API 通信エラーや処理問題をカスタムの GhostError 例外で処理し、トラブルシューティングを容易にするために明確で詳細なエラーメッセージを提供します。

コントリビューションガイド

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

📄 ライセンス

MIT