DevHub CMS

What is DevHub CMS about?

Enables LLMs to interact with the DevHub CMS platform through a set of MCP‑compatible tools, covering business and location data, blog content, and media assets.

How to use DevHub CMS?

1. Install the server – the project relies on the uv package manager. After cloning, run:

   uv run main.py
   

   For a global install via Claude Desktop or other clients, configure the MCP server as described below.
2. Configure environment variables – the server needs three secrets:

   export DEVHUB_API_KEY="your_api_key"
   export DEVHUB_API_SECRET="your_api_secret"
   export DEVHUB_BASE_URL="https://yourbrand.cloudfrontend.net"
   

3. Add the server to Claude Desktop (or Cursor, Claude Code, Smithery) by inserting a block into claude_desktop_config.json:

   {
     "mcpServers": {
       "devhub_cms_mcp": {
         "command": "uv",
         "args": ["run", "main.py"],
         "env": {
           "DEVHUB_API_KEY": "YOUR_KEY_HERE",
           "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
           "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
         }
       }
     }
   }
   

   Restart Claude Desktop after saving.
4. Run the test suite (optional) to verify functionality without network calls:

   uv pip install -e "[test]"
   uv run pytest -v --cov=devhub_cms_mcp
   

Key Features

• Business & Location Management: list businesses, fetch locations, read/update hours, locate nearest site, resolve site IDs from URLs.
• Content Management: retrieve, create, and update blog posts (HTML, no H1 tag).
• Media Management: upload images via base64 (webp, jpeg, png).
• LLM‑ready MCP interface: all tools are exposed as MCP methods, allowing seamless invocation from Claude, Cursor, or any MCP‑compatible agent.

Use Cases

• Automated generation and publishing of blog posts by an LLM writer.
• Real‑time updating of store hours across multiple locations based on natural‑language instructions.
• Finding the nearest store for a user query and returning a shareable link.
• Bulk image uploading from a document conversion pipeline.
• Centralized content governance where the LLM validates and pushes changes without exposing raw API keys to end users.

FAQ

Q: Which package manager is required? A: uv (https://github.com/astral-sh/uv). It can also be invoked via uvx for one‑off runs.

Q: Can I run the server on Windows? A: Yes, uv works cross‑platform. Ensure the environment variables are set in the command prompt or PowerShell before launching.

Q: Do I need to expose my DevHub credentials to the LLM? A: No. Credentials are stored in the server’s environment and are never sent to the LLM; the LLM only calls the MCP methods.

Q: How do I integrate with Claude Code? A: Use the claude mcp add command shown in the README, passing the same three environment variables.

Q: Is there a way to install automatically via Smithery? A: Yes, run npx -y @smithery/cli install @devhub/devhub-cms-mcp --client claude.

DevHub CMS MCP

A Model Context Protocol (MCP) integration for managing content in the DevHub CMS system.

Installation

You will need the uv package manager installed on your local system.

Manual configuration of Claude Desktop

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uvx",
            "args": [
                "devhub-cms-mcp"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

After updating the config, restart Claude Desktop.

Manual configuration for Cursor

This MCP can also be used in cursor with a similar configuration from above added to your Cursor global environment or to individual projects.

Examples here

Installing via Claude Code

Claude Code's command line supports MCP installs.

You can add the devhub-cms-mcp by updating the environment variables below

claude mcp add devhub-cms-mcp \
    -e DEVHUB_API_KEY=YOUR_KEY_HERE \
    -e DEVHUB_API_SECRET=YOUR_SECRET_HERE \
    -e DEVHUB_BASE_URL=https://yourbrand.cloudfrontend.net \
    -- uvx devhub-cms-mcp

Installing via Smithery

To install DevHub CMS MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @devhub/devhub-cms-mcp --client claude

Local development

Clone the repo (or your fork)

git clone git@github.com:devhub/devhub-cms-mcp.git

Manual configuration of Claude Desktop

To use this server with the Claude Desktop app for local development, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/YOUR/LOCAL/PATH/devhub-cms-mcp/",
                "run",
                "main.py"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

After updating the config, restart Claude Desktop.

Configuration for running with uv directly

This MCP requires the following environment variables to be set:

export DEVHUB_API_KEY="your_api_key"
export DEVHUB_API_SECRET="your_api_secret"
export DEVHUB_BASE_URL="https://yourbrand.cloudfrontend.net"

Then run the MCP

uv run main.py

Available Tools

This MCP provides the following tools for interacting with DevHub CMS:

Business and Location Management

• get_businesses(): Gets all businesses within the DevHub account. Returns a list of businesses with their IDs and names.
• get_locations(business_id): Gets all locations for a specific business. Returns detailed location information including address, coordinates, and URLs.
• get_hours_of_operation(location_id, hours_type='primary'): Gets the hours of operation for a specific DevHub location. Returns a structured list of time ranges for each day of the week.
• update_hours(location_id, new_hours, hours_type='primary'): Updates the hours of operation for a DevHub location.
• get_nearest_location(business_id, latitude, longitude): Finds the nearest DevHub location based on geographic coordinates.
• site_from_url(url): Gets the DevHub site ID and details from a URL. Returns site ID, URL, and associated location IDs.

Content Management

• get_blog_post(post_id): Retrieves a single blog post by ID, including its title, date, and HTML content.
• create_blog_post(site_id, title, content): Creates a new blog post. The content should be in HTML format and should not include an H1 tag.
• update_blog_post(post_id, title=None, content=None): Updates an existing blog post's title and/or content.

Media Management

• upload_image(base64_image_content, filename): Uploads an image to the DevHub media gallery. Supports webp, jpeg, and png formats. The image must be provided as a base64-encoded string.

Usage with LLMs

This MCP is designed to be used with Large Language Models that support the Model Context Protocol. It allows LLMs to manage content in DevHub CMS without needing direct API access integrated into the LLM natively.

Testing

This package includes a test suite with mocked requests to the DevHub API, allowing you to test the functionality without making actual API calls.

Running Tests

To run the tests, first install the package with test dependencies:

uv pip install -e ".[test]"

Run the tests with pytest:

uv run pytest

For more detailed output and test coverage information:

uv run pytest -v --cov=devhub_cms_mcp

Test Structure

• tests/devhub_cms_mcp/test_mcp_integration.py: Tests for MCP integration endpoints