Ghost MCP

Ein MCP-Server für die Ghost-Blogging-Plattform mit Server-Sent-Events (SSE)-Unterstützung.

Dokumentation

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