README Documentation
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
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source