Ghost

You run a Ghost MCP Server that exposes Ghost Admin API functionality through MCP tools over an SSE transport channel. This server lets you manage Ghost content such as posts, pages, and tags from any MCP client, while keeping secure defaults and straightforward environment-based configuration.

How to use

Connect your MCP client to the server at the SSE endpoint http://localhost:3064/sse. Use the client’s MCP feature set to list, create, update, and delete Ghost content. The server provides tools to work with posts, pages, and tags, and communicates changes in real time via Server-Sent Events when available.

How to install

Prerequisites you need before installation:

• Docker and Docker Compose installed on your system
• Node.js and npm available if you plan to run locally without Docker

Step 1: Prepare environment variables. Create a copy of the example environment file and edit it with your Ghost credentials.

cp .env.example .env

# Edit the .env file to include your Ghost API credentials and server settings
GHOST_URL=https://your-ghost-blog.com
GHOST_KEY_ID=your_ghost_key_id_here
GHOST_KEY_SECRET=your_ghost_key_secret_here
PORT=3064
NODE_ENV=production

Step 2: Run the server with Docker Compose. This is the simplest way to start the MCP server and its dependencies in detached mode.

docker-compose up -d

Step 3: If you prefer running the container directly, build the image and start the container with your environment file.

# Build the image
docker build -t oculair/ghost-mcp:1.0.0 .

# Run the container with your environment file
docker run -p 3064:3064 --env-file .env --rm -it oculair/ghost-mcp:1.0.0

Step 4: For multi-architecture environments, enable Docker Buildx and build for multiple platforms. This enables images for amd64 and arm64.

docker buildx create --use --name multiarch-builder
docker buildx inspect --bootstrap

docker buildx build --platform linux/amd64,linux/arm64 \
  -t oculair/ghost-mcp:1.0.0 \
  --push .

docker manifest inspect oculair/ghost-mcp:1.0.0

Additional setup and notes

Health checks are exposed through a dedicated endpoint to verify the server is running and reachable. Ensure your Ghost API credentials have the required permissions to access Admin API features.

Security and configuration

The server runs with a non-root user inside Docker for better security. Configure credentials and network access using the environment file you provide at runtime. If you manage sensitive Ghost data, limit access to the SSE endpoint and use appropriate network policies.

Available tools

Posts

Create, list, update, and delete Ghost posts through the MCP tools set.

Pages

Create, list, update, and delete Ghost pages through the MCP tools set.

Tags

Create and update Ghost tags through the MCP tools set.