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

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

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

License

MIT