Ghost MCP Server logo

Ghost MCP Server

by jgardner04

The Ghost MCP Server allows an MCP client to interact with a Ghost CMS instance via defined tools. It exposes Ghost CMS management functions as MCP tools, enabling AI clients to manage a Ghost blog.

View on GitHub

Last updated: N/A

What is Ghost MCP Server?

The Ghost MCP Server is a Model Context Protocol (MCP) server that exposes Ghost CMS management functions as tools, enabling AI clients like Cursor or Claude Desktop to interact with and manage a Ghost blog.

How to use Ghost MCP Server?

  1. Clone the repository. 2. Install dependencies using npm install. 3. Configure environment variables in a .env file with your Ghost Admin API URL and Key. 4. Run the server using npm start or node src/index.js. An MCP client can then connect to the server (typically at http://localhost:3001) to discover and use the defined tools.

Key features of Ghost MCP Server

  • Exposes Ghost CMS resources (tags, posts) as MCP resources.

  • Provides tools for creating tags (ghost_create_tag), retrieving tags (ghost_get_tags), uploading images (ghost_upload_image), and creating posts (ghost_create_post).

  • Allows AI clients to automate Ghost CMS content management tasks.

  • Supports configuration via environment variables for API keys and ports.

Use cases of Ghost MCP Server

  • Automated content creation and publishing in Ghost CMS.

  • AI-powered tag management and organization.

  • Integration of Ghost CMS with AI writing assistants.

  • Programmatic management of Ghost CMS posts and media.

FAQ from Ghost MCP Server

What are the requirements for running the Ghost MCP Server?

Node.js 14.0.0 or higher and a Ghost Admin API URL and Key.

How do I find my Ghost Admin API URL and Key?

In your Ghost Admin settings, go to Integrations -> Custom Integrations.

What port does the MCP server run on by default?

The MCP server typically runs on port 3001 by default.

What do I do if I get a 401 Unauthorized error from Ghost?

Check that your GHOST_ADMIN_API_URL and GHOST_ADMIN_API_KEY in the .env file are correct and that the Custom Integration in Ghost is enabled.

What do I do if I have MCP server connection issues?

Ensure the MCP server is running (check console logs). Verify the port (MCP_PORT, default 3001) is not blocked by a firewall. Check that the client is connecting to the correct address and port.