DevHub CMS MCP

这是一个用于管理 DevHub CMS 系统 内容的 Model Context Protocol (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 自动安装 DevHub CMS MCP 到 Claude Desktop：

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

本地开发

克隆仓库（或你的分支）

git clone git@github.com: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 设计用于与支持 Model Context Protocol 的大型语言模型一起使用。它允许大型语言模型无需直接集成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 集成端点