Interact with the Ghost blogging platform using the Model Context Protocol (MCP) with Server-Sent Events (SSE) support.
This repository contains a Model Context Protocol (MCP) server implementation for the Postiz platform.
Copy the example environment file:
cp .env.example .env
Edit the .env
file with your Postiz API credentials:
POSTIZ_API_URL=https://your-postiz-instance.com/api
POSTIZ_API_KEY=your_postiz_api_key_here
PORT=3084
NODE_ENV=production
The easiest way to run the server is with Docker Compose:
docker-compose up -d
This will build the image if needed and start the server in detached mode.
You can also build and run the Docker image directly:
# Build the image
docker build -t oculair/postiz-mcp:latest .
# Run the container
docker run -p 3084:3084 --env-file .env --rm -it oculair/postiz-mcp:latest
To build for multiple architectures (amd64 and arm64):
Enable Docker Buildx:
docker buildx create --use --name multiarch-builder
docker buildx inspect --bootstrap
Build and push:
docker buildx build --platform linux/amd64,linux/arm64 \
-t oculair/postiz-mcp:latest \
--push .
Verify the multi-architecture image:
docker manifest inspect oculair/postiz-mcp:latest
.
├── everything/
│ ├── src/
│ │ ├── core/ # Core server implementation
│ │ ├── tools/ # MCP tool implementations
│ │ ├── transports/ # Transport implementations (SSE, stdio)
│ │ └── index.js # Main entry point
│ └── package.json # Node.js dependencies
├── .env.example # Example environment variables
├── .gitignore # Git ignore file
├── compose.yaml # Docker Compose configuration
├── Dockerfile # Docker build configuration
└── README.md # This file
The server provides the following MCP tools:
create-post
get-posts
get-integrations
get-self
login
For detailed information about each tool and its parameters, see the everything/README.md file.
To debug the container, you can run it with an interactive shell:
docker run -p 3084:3084 --env-file .env --rm -it --entrypoint bash oculair/postiz-mcp:latest
Add to your claude_desktop_config.json
:
{
"mcpServers": {
"postiz": {
"url": "http://localhost:3084/sse",
"disabled": false,
"alwaysAllow": []
}
}
}
A server for interacting with the AgentMail API for email communication. Requires an API key.
Provides access to Intercom conversations and chats. Requires an Intercom API key.
A Discord relay server to send messages and prompts to a channel and receive responses.
A Text-to-Speech server that integrates with an external VOICEVOX engine.
An open-source messaging server for client-to-client communication using MCP HTTP Streamable messaging.
A server for collecting user feedback and AI work reports.
Access and interact with MyMCPSpace posts, replies, likes, and feeds.
Query live Gmail data using LLMs via CData's read-only MCP server.
A production-ready MCP server for ChatGPT and o3-pro, featuring caching, cost tracking, and rate limiting.
An open-source messaging server for client-to-client communication using MCP HTTP streaming, configurable via an external JSON file.