Ghost MCP

★ 3

from oculairmedia

An MCP server for the Ghost blogging platform with Server-Sent Events (SSE) support.

🔥🔥🔥✓ VerifiedFreeNeeds API keys

Ghost MCP Server

MCP (Model Context Protocol) server for Ghost CMS blog integration. Enables AI agents and LLMs to manage Ghost blog content through standardized MCP tools.

Directory Structure

.
├── index.js              # Main entry point
├── core/                 # Core server functionality
│   ├── server.js         # GhostServer class with API communication
│   └── api-client.js     # Shared Ghost API utilities and JWT auth
├── tools/                # MCP tool implementations
│   ├── index.js          # Tool registry and handlers
│   ├── ghost-tools.js    # Tool exports and definitions
│   ├── create-ghost-post.js
│   ├── list-ghost-posts.js
│   ├── update-ghost-post.js
│   ├── delete-ghost-post.js
│   ├── create-ghost-page.js
│   ├── list-ghost-pages.js
│   ├── update-ghost-page.js
│   ├── delete-ghost-page.js
│   ├── create-ghost-tag.js
│   └── update-ghost-tag.js
├── transports/           # Server transport implementations
│   ├── index.js          # Transport exports
│   ├── stdio-transport.js
│   ├── sse-transport.js
│   └── http-transport.js # Streamable HTTP (default)
└── __tests__/            # Test files

Available Tools

Tool	Description
`create_ghost_post`	Create a new blog post
`list_ghost_posts`	List posts with pagination
`update_ghost_post`	Update an existing post
`delete_ghost_post`	Delete a post
`create_ghost_page`	Create a new page
`list_ghost_pages`	List pages with pagination
`update_ghost_page`	Update an existing page
`delete_ghost_page`	Delete a page
`create_ghost_tag`	Create a new tag
`update_ghost_tag`	Update an existing tag

Environment Variables

Variable	Description	Required
`GHOST_API_URL`	Ghost instance URL	Yes
`GHOST_ADMIN_KEY`	Admin API key (format: `id:secret`)	Yes
`PORT`	Server port (default: 3064)	No
`NODE_ENV`	Environment mode	No

Docker

# Build image
docker build -t ghost-mcp .

# Run container
docker run -p 3064:3064 \
  -e GHOST_API_URL=https://your-ghost-blog.com \
  -e GHOST_ADMIN_KEY=your-key-id:your-key-secret \
  ghost-mcp

API Endpoints

POST /mcp - MCP request endpoint
GET /mcp - SSE streaming endpoint
DELETE /mcp - Session termination
GET /health - Health check

Copy & paste — that's it

# Build image
docker build -t ghost-mcp .

# Run container
docker run -p 3064:3064 \
 -e GHOST_API_URL=https://your-ghost-blog.com \
 -e GHOST_ADMIN_KEY=your-key-id:your-key-secret \
 ghost-mcp

Before it works, you'll need: GHOST_ADMIN_KEY

Running the Server

# HTTP transport (default, for production)
npm start

# SSE transport
npm run start:sse

# Stdio transport (for CLI integration)
npm run start:stdio

# Development
npm run dev

# Run tests
npm test