remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides secure and comprehensive access to Ghost CMS blogs, enabling management of posts, users, members, tiers, offers, and newsletters through LLM interfaces

ゴーストMCPサーバー

ClaudeなどのLLMインターフェースを介してGhost CMSと連携するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、JWT認証と豊富なMCPツールを活用し、投稿、ユーザー、メンバー、ティア、オファー、ニュースレターを管理することで、Ghostブログへの安全かつ包括的なアクセスを提供します。

特徴

Ghost Admin API リクエストの安全な JWT 認証
投稿、ユーザー、メンバー、ティア、オファー、ニュースレターを含む包括的なエンティティアクセス
あいまい一致と完全一致の両方のオプションを備えた高度な検索機能
Ghostエンティティの詳細な、人間が読める出力
カスタムGhostError例外を使用した堅牢なエラー処理
MCP コンテキストによる統合ログサポートによりトラブルシューティングが強化されます

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Ghost MCP Server を自動的にインストールするには:

npx -y @smithery/cli install @MFYDev/ghost-mcp --client claude

手動インストール

# Clone repository
git clone git@github.com/mfydev/ghost-mcp.git
cd ghost-mcp

# Create virtual environment and install
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

要件

Python ≥ 3.12
管理 API アクセスで Ghost インスタンスを実行する (v5.x 以上を推奨)
Node.js (MCP Inspector によるテスト用)

使用法

環境変数

GHOST_API_URL=https://yourblog.com  # Your Ghost Admin API URL
GHOST_STAFF_API_KEY=your_staff_api_key                 # Your Ghost Staff API key

MCPクライアントでの使用

これを MCP クライアント (たとえば、Claude Desktop) で使用するには、 claude_desktop_config.jsonに次のコードを追加します。

{
  "mcpServers": {
    "ghost": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/ghost-mcp",
        "run",
        "src/main.py"
      ],
      "env": {
        "GHOST_API_URL": "your_ghost_api_url",
        "GHOST_STAFF_API_KEY": "your_staff_api_key"
      }
    }
  }
}

MCP Inspectorによるテスト

GHOST_API_URL=your_ghost_api_url GHOST_STAFF_API_KEY=your_staff_api_key npx @modelcontextprotocol/inspector uv --directory /path/to/ghost-mcp run src/main.py

利用可能なツール

Ghost MCP は、すべての Ghost CMS 機能へのアクセスを提供する単一の統合ツールを提供するようになりました。

メインツール

ghost : Ghost CMS のすべての機能にアクセスするための中心的なツール

ゴーストツールの使用

ゴーストツールは、主に 2 つのパラメータを受け入れます。

action : 実行する特定のゴースト操作
params : 指定されたアクションのパラメータの辞書

使用例:

# List posts
ghost(action="list_posts", params={"format": "text", "page": 1, "limit": 15})

# Search posts by title
ghost(action="search_posts_by_title", params={"query": "Welcome", "exact": False})

# Create a post
ghost(action="create_post", params={
    "post_data": {
        "title": "New Post via MCP",
        "status": "draft",
        "lexical": "{\"root\":{\"children\":[{\"children\":[{\"detail\":0,\"format\":0,\"mode\":\"normal\",\"style\":\"\",\"text\":\"Hello World\",\"type\":\"text\",\"version\":1}],\"direction\":\"ltr\",\"format\":\"\",\"indent\":0,\"type\":\"paragraph\",\"version\":1}],\"direction\":\"ltr\",\"format\":\"\",\"indent\":0,\"type\":\"root\",\"version\":1}}"
    }
})

利用可能なアクション

ゴーストツールは以前と同じアクションをすべてサポートしますが、統合されたインターフェースを通じてサポートされるようになりました。

投稿アクション

list_posts : ページ区切り付きのブログ投稿を一覧表示する
search_posts_by_title : タイトルで投稿を検索する
read_post : 特定の投稿の全コンテンツを取得する
create_post : 新しい投稿を作成する
update_post : 特定の投稿を更新する
delete_post : 特定の投稿を削除する
batchly_update_posts : 1回のリクエストで複数の投稿を更新する

タグアクション

browse_tags : すべてのタグを一覧表示する
read_tag : 特定のタグ情報を取得する
create_tag : 新しいタグを作成する
update_tag : 既存のタグを更新する
delete_tag : 特定のタグを削除する

ユーザーのアクション

list_roles : 利用可能なすべてのロールを一覧表示する
create_invite : 新しいユーザーの招待を作成する
list_users : すべてのユーザーを一覧表示する
read_user : 特定のユーザーの詳細を取得する
delete_user : 特定のユーザーを削除する

メンバーのアクション

list_members : メンバーをリストする
read_member : 特定のメンバー情報を取得する
create_member : 新しいメンバーを作成する
update_member : 既存のメンバーを更新する

ティアアクション

list_tiers : すべての会員レベルを一覧表示する
read_tier : 特定の階層情報を取得する
create_tier : 新しい層を作成する
update_tier : 既存の層を更新する

オファーアクション

list_offers : プロモーションオファーを一覧表示する
read_offer : 特定のオファー情報を取得する
create_offer : 新しいオファーを作成する
update_offer : 既存のオファーを更新する

ニュースレターアクション

list_newsletters : すべてのニュースレターを一覧表示する
read_newsletter : 特定のニュースレター情報を取得する
create_newsletter : 新しいニュースレターを作成する
update_newsletter : 既存のニュースレターを更新する

Webhookアクション

create_webhook : 新しいWebhookを作成する
update_webhook : 既存のWebhookを更新する
delete_webhook : 特定のウェブフックを削除する

利用可能なリソース

すべてのリソースはURIパターンに従います: [type]://[id]

user://{user_id} : ユーザープロファイルとロール
member://{member_id} : メンバーの詳細とサブスクリプション
tier://{tier_id} : 階層構成
offer://{offer_id} : オファーの詳細
newsletter://{newsletter_id} : ニュースレターの設定
post://{post_id} : 投稿コンテンツとメタデータ
blog://info : 一般的なブログ情報

エラー処理

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

貢献

フォークリポジトリ
機能ブランチを作成する
変更をコミットする
プルリクエストを作成する

ライセンス

マサチューセッツ工科大学

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

View all tools

LLM インターフェースを介して Ghost CMS とのやり取りを可能にし、詳細な出力とエラー処理を備えた投稿、ユーザー、ニュースレターを管理するための JWT 認証による安全なアクセスを提供します。

Related Resources

Reddit Discussion about this server

Appeared in Searches

Information about ghosts