DevHub CMS MCP

DevHub CMS MCP

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

安装

你需要 紫外线 安装在本地系统上的包管理器。

Claude Desktop的手动配置

将此服务器与 克劳德桌面应用程序，将以下配置添加到您的“mcpServers”部分 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"
            }
        }
    }
}

更新配置后，重新启动Claude Desktop。

Cursor的手动配置

此MCP也可以在游标中使用，并将上述类似配置添加到您的 光标 全球环境或单个项目。

例子 这里

通过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安装

通过以下方式自动安装DevHub CMS MCP for 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应用程序一起用于本地开发，请将以下配置添加到您的“mcpServers”部分 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"
            }
        }
    }
}

更新配置后，重新启动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_businesss（）：获取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、纬度、经度）：根据地理坐标查找最近的DevHub位置。
• site_from_url（url）：从URL获取DevHub站点ID和详细信息。返回站点ID、URL和关联的位置ID。

内容管理

• get_blog_post（post_id）：按ID检索单个博客文章，包括其标题、日期和HTML内容。
• create_blog_post（站点id、标题、内容）：创建新的博客文章。内容应采用HTML格式，不应包含H1标签。
• update_blog_post（post_id，title=无，content=无）：更新现有博客文章的标题和/或内容。

媒体管理

• upload_image（base64_image_content，文件名）：将图像上传到DevHub媒体库。支持webp、jpeg和png格式。图像必须以base64编码字符串的形式提供。

与LLM一起使用

此MCP旨在与支持模型上下文协议的大型语言模型一起使用。它允许LLM在DevHub CMS中管理内容，而无需直接访问本机集成到LLM中的API。

测试

该包包含一个测试套件，其中包含对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集成端点测试