Ghost MCP Server

Ghost MCP サーバー

Ghost Admin API と統合する Model Context Protocol（MCP）サーバーです。このサーバーを使用すると、投稿の管理、ページの管理、メンバーの管理など、Ghost CMS の機能にプログラムからアクセスできます。

機能

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

前提条件

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

インストール

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

npm install @mtane0412/ghost-mcp-server

設定

1. Ghost Admin ダッシュボードの Settings > Integrations で、新しいカスタムインテグレーションを作成します。

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", // Optional: Number of posts to retrieve (1-100, default: 10)
  "page": "number"   // Optional: Page number (default: 1)
}

get_post

ID を指定して特定の投稿を取得します。

入力：

{
  "id": "string" // Required: Post ID
}

search_posts

投稿を検索します。

入力：

{
  "query": "string", // Required: Search query
  "limit": "number"  // Optional: Number of posts to retrieve (1-100, default: 10)
}

create_post

新しい投稿を作成します。

入力：

{
  "title": "string",     // Required: Post title
  "html": "string",      // Optional: HTML content
  "lexical": "string",   // Optional: Lexical content
  "status": "string",    // Optional: Post status (published/draft/scheduled)
  "visibility": "string" // Optional: Visibility level (public/members/paid/tiers)
}

update_post

既存の投稿を更新します。

入力：

{
  "id": "string",       // Required: Post ID
  "title": "string",    // Optional: Post title
  "html": "string",     // Optional: HTML content
  "lexical": "string",  // Optional: Lexical content
  "status": "string"    // Optional: Post status
}

delete_post

投稿を削除します。

入力：

{
  "id": "string" // Required: Post ID
}

get_pages

ページの一覧を取得します。

入力：

{
  "limit": "number",     // Optional: Number of pages to retrieve (1-100, default: 10)
  "page": "number",      // Optional: Page number (default: 1)
  "order": "string",     // Optional: Sort order
  "formats": ["string"], // Optional: Content formats (html/mobiledoc/lexical)
  "include": ["string"]  // Optional: Related data to include (authors/tags)
}

get_members

メンバーの一覧を取得します。

入力：

{
  "limit": "number",     // Optional: Number of members to retrieve (1-100, default: 10)
  "page": "number",      // Optional: Page number (default: 1)
  "order": "string",     // Optional: Sort order
  "include": ["string"]  // Optional: Related data to include (labels/newsletters)
}

search_members

メンバーを検索します。

入力：

{
  "query": "string",     // Required: Search query
  "limit": "number",     // Optional: Number of members to retrieve (1-100, default: 10)
  "include": ["string"]  // Optional: Related data to include (labels/newsletters)
}

upload_image

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

入力：

{
  "file": "string",   // Required: Base64 encoded image data
  "purpose": "string" // Optional: Image purpose (image/profile_image/icon)
}

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトとして利用できる MCP Inspector の使用をおすすめします：

npm run inspect

Inspector は、ブラウザーでデバッグツールにアクセスするための URL を表示します。

ライセンス

MIT ライセンス