Ghost MCP Server

# 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 ```bash # 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 ```bash # 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