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 endpointGET /mcp- SSE streaming endpointDELETE /mcp- Session terminationGET /health- Health check
License
MIT