Ghost MCP Server

A server that integrates Ghost CMS with Claude AI through the FastMCP framework.

Requirements

• Python 3.11+
• uv - Required to run this server

Setup

1. Clone the repository
2. Create a virtual environment (optional but recommended):

   uv venv
   source .venv/bin/activate  # On Windows: .venv\\Scripts\\activate
   

3. Install dependencies using uv (dependencies are defined in pyproject.toml):

   uv pip install .
   

4. Set up environment variables by copying .env.example to .env:

   cp .env.example .env
   

5. Configure your .env file with your Ghost API credentials:

   GHOST_API_KEY=your_ghost_api_key_here
   GHOST_API_URL=https://your-ghost-blog.com/ghost/api/admin/posts
   GHOST_API_VERSION=v5.116.1
   

Claude Desktop Configuration

To use this server with Claude Desktop, you need to configure it in Claude's MCP settings:

1. Open Claude Desktop
2. Go to Settings > Developer > MCP Servers
3. Add a new MCP Server configuration similar to:

{
  "mcpServers": {
    "ghost-mcp": {
      "command": "/path/to/your/uv",
      "args": [
        "--directory",
        "/path/to/your/ghost-mcp",
        "run",
        "mcp_server.py"
      ]
    }
  }
}

Replace /path/to/your/uv with the actual path to your uv executable and /path/to/your/ghost-mcp with the absolute path to this project directory.

Usage

Once configured, you can use the ghost_post tool from Claude to create blog posts directly in your Ghost CMS:

Create a blog post with title "My First Post" and content "Hello, world!"

The tool supports the following parameters:

• title: The title of the blog post
• content: Markdown content for the post
• author_id: ID of the author (default: "1")
• tags: List of tag names
• status: Post status (draft, published)
• feature_image: URL for the post's cover image
• code_language: Default language for code blocks