Ghost

Ghost

A Model Context Protocol (MCP) server for interacting with Ghost CMS through LLM interfaces like Claude.

109
Stars
30
Forks
1
Releases

Overview

Ghost MCP Server is a Model Context Protocol (MCP) server that enables secure, comprehensive access to a Ghost CMS instance from LLM interfaces such as Claude. In this v0.1.0 release, the project migrated from Python to TypeScript and is now distributed as an NPM package (@fanyangmeng/ghost-mcp). The server uses the official @tryghost/admin-api client for all Admin API requests, improving reliability and maintainability, and supports streamlined configuration via environment variables. It exposes a rich set of MCP tools to manage Ghost entities including posts, users, members, tiers, offers, newsletters, invites, roles, tags, and webhooks. Features include advanced search (fuzzy and exact), detailed, human-readable outputs, robust error handling with a custom GhostError, and integrated MCP-context logging for troubleshooting. The README also provides a usage snippet for Claude Desktop configuration and notes breaking changes introduced by the migration, such as Python dependencies no longer being required and a simplified Docker/NPM-based deployment path. Overall, Ghost MCP Server aims to simplify secure programmatic Ghost operations from language model workflows.

Details

Owner
MFYDev
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Secure Ghost Admin API requests with @tryghost/admin-api

Uses the official Ghost Admin API client to securely access Ghost data.

Comprehensive entity access including posts, users, members, tiers, offers, and newsletters

Provides complete access to core Ghost entities through MCP.

Advanced search functionality with both fuzzy and exact matching options

Supports flexible search queries with fuzzy and exact matching.

Detailed, human-readable output for Ghost entities

Returns clear, descriptive results suitable for display to users.

Robust error handling using custom GhostError exceptions

Gracefully handles API and processing errors with GhostError.

Integrated logging support via MCP context for enhanced troubleshooting

Includes MCP-context logging to aid debugging and monitoring.

Audience

MCP clientsInteract with Ghost data from LLM workflows (e.g., Claude Desktop)
Claude Desktop usersConfigure Claude Desktop to access Ghost resources via the Ghost MCP server.

Tags

GhostMCPGhost CMSAdmin APIJWTLLMClaudeTypeScriptNode.jsnpmGhost Admin APIpostsusersmembersnewslettersoffersinvitesrolestagstierswebhooks