DevHub CMS MCP

DevHub CMS MCP

用于管理 DevHub CMS 系统内容的 模型上下文协议（MCP）集成。

安装

你需要在本地系统上安装 uv 包管理器。

手动配置 Claude Desktop

若要将此服务与 Claude Desktop 应用配合使用，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

{
    "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"
            }
        }
    }
}

更新配置后，重启 Claude Desktop。

手动配置 Cursor

此 MCP 也可在 Cursor 中使用，只需将上述类似的配置添加到 Cursor 全局环境或单个项目中。

示例见这里

通过 Claude Code 安装

Claude Code 的命令行支持安装 MCP。

你可以通过更新以下环境变量来添加 devhub-cms-mcp

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

通过 Smithery 安装

若要通过 Smithery 自动为 Claude Desktop 安装 DevHub CMS MCP：

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

本地开发

克隆仓库（或你的分叉）

git clone [email protected]:devhub/devhub-cms-mcp.git

手动配置 Claude Desktop

若要在本地开发时将此服务与 Claude Desktop 应用配合使用，请将以下配置添加到 claude_desktop_config.json 的 "mcpServers" 部分：

{
    "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"
            }
        }
    }
}

更新配置后，重启 Claude Desktop。

配置以直接使用 uv 运行

此 MCP 需要设置以下环境变量：

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

然后运行 MCP

uv run main.py

可用工具

此 MCP 提供以下工具，可用于与 DevHub CMS 交互：

企业与地点管理

• get_businesses()：获取 DevHub 账户中的所有企业。返回包含企业 ID 和名称的列表。
• get_locations(business_id)：获取指定企业的所有地点。返回详细的地点信息，包括地址、坐标和 URL。
• get_hours_of_operation(location_id, hours_type='primary')：获取指定 DevHub 地点的营业时间。返回一份结构化列表，列出每周各天的时间范围。
• update_hours(location_id, new_hours, hours_type='primary')：更新 DevHub 地点的营业时间。
• get_nearest_location(business_id, latitude, longitude)：根据地理坐标查找最近的 DevHub 地点。
• site_from_url(url)：根据 URL 获取 DevHub 站点 ID 和详情。返回站点 ID、URL 和关联的地点 ID。

内容管理

• get_blog_post(post_id)：按 ID 获取单篇博客文章，包括标题、日期和 HTML 内容。
• create_blog_post(site_id, title, content)：创建一篇新的博客文章。内容应为 HTML 格式，且不应包含 H1 标签。
• update_blog_post(post_id, title=None, content=None)：更新现有博客文章的标题和／或内容。

媒体管理

• upload_image(base64_image_content, filename)：将图片上传到 DevHub 媒体库。支持 webp、jpeg 和 png 格式。图片必须以 Base64 编码字符串的形式提供。

与大模型配合使用

此 MCP 专为支持模型上下文协议的大语言模型而设计。它让大模型无需原生集成直接 API 访问能力，即可管理 DevHub CMS 中的内容。

测试

此软件包包含一个测试套件，其中使用模拟请求调用 DevHub API，因此你可以在不发起实际 API 调用的情况下测试功能。

运行测试

要运行测试，请先安装包含测试依赖项的软件包：

uv pip install -e ".[test]"

使用 pytest 运行测试：

uv run pytest

查看更详细的输出和测试覆盖率信息：

uv run pytest -v --cov=devhub_cms_mcp

测试结构

• tests/devhub_cms_mcp/test_mcp_integration.py：MCP 集成端点的测试