Ghost Admin API

🚀 鬼魂 MCP サーバー

このサーバーは、Ghost管理コンソールAPIを統合したModel Context Protocol (MCP) サーバーです。Ghost CMSの機能（記事管理、ページ管理、メンバー管理など）をプログラムでアクセスできるようにします。

🚀 クイックスタート

鬼魂 MCP サーバーは、Ghost管理コンソールAPIと統合されたMCPサーバーで、Ghost CMSの様々な機能をプログラムで利用できます。以下の手順でセットアップして使用しましょう。

✨ 主な機能

• 記事管理（作成、読み取り、更新、削除、検索）
• ページ管理（作成、読み取り、更新、削除）
• タグ管理
• 著者管理
• メンバー管理（作成、読み取り、更新、削除、検索）
• 画像アップロードサポート

📦 インストール

前提条件

• Node.js（v18以上を推奨）
• Ghost CMSインスタンス
• Ghost管理APIキー

インストール手順

npmを使ってパッケージをインストールします。

npm install @mtane0412/ghost-mcp-server

📚 ドキュメント

設定

1. Ghost管理コンソールのダッシュボードで、設定 > 統合 から新しいカスタム統合を作成します。
2. 以下の環境変数を設定します。

# macOS/Linux
export GHOST_URL="https://your-ghost-blog.com"
export GHOST_ADMIN_API_KEY="your_admin_api_key"

# Windows (PowerShell)
$env:GHOST_URL="https://your-ghost-blog.com"
$env:GHOST_ADMIN_API_KEY="your_admin_api_key"

または、.env ファイルを作成します。

GHOST_URL=https://your-ghost-blog.com
GHOST_ADMIN_API_KEY=your_admin_api_key

使用方法

インストールが完了したら、サーバーを起動します。

npx @mtane0412/ghost-mcp-server

利用可能なツール

get_posts

記事のリストを取得します。 入力：

{
  "limit": "number", // オプション：取得する記事の数（1-100、デフォルト：10）
  "page": "number"   // オプション：ページ番号（デフォルト：1）
}

get_pages

ページのリストを取得します。 入力：

{
  "limit": "number", // オプション：取得するページの数（1-100、デフォルト：10）
  "page": "number"   // オプション：ページ番号（デフォルト：1）
}

get_tags

タグのリストを取得します。 入力：

{
  "limit": "number", // オプション：取得するタグの数（1-100、デフォルト：10）
  "page": "number"   // オプション：ページ番号（デフォルト：1）
}

get_authors

著者のリストを取得します。 入力：

{
  "limit": "number", // オプション：取得する著者の数（1-100、デフォルト：10）
  "page": "number"   // オプション：ページ番号（デフォルト：1）
}

get_members

メンバーのリストを取得します。 入力：

{
  "limit": "number", // オプション：取得するメンバーの数（1-100、デフォルト：10）
  "page": "number"   // オプション：ページ番号（デフォルト：1）
}

upload_image

画像をアップロードします。 入力：

{
  "file": "string",   // 必須：Base64エンコードされた画像データ
  "purpose": "string" // オプション：画像の用途（image/profile_image/icon）
}

デバッグ

MCPサーバーは標準入出力で通信するため、デバッグは難しい場合があります。MCPインスペクターを使うことをおすすめします。これはパッケージスクリプトとして提供されています。

npm run inspect

インスペクターは、ブラウザでデバッグツールにアクセスするためのURLを提供します。

📄 ライセンス

MITライセンス