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 结合使用，只需在全局环境或特定项目中添加类似的配置即可。示例请参见此处。

使用 Claude Code 安装

Claude Code 支持通过以下命令安装：

uv pip install devhub-cms-mcp

本地开发

要使用 MCP 进行本地开发，请执行以下步骤：

1. 克隆仓库：

   git clone https://github.com/your-username/devhub-cms-mcp.git
   cd devhub-cms-mcp
   

2. 安装依赖项：

   uv pip install -r requirements.txt
   

使用

要启动 MCP，请运行：

uv run devhub_cms_mcp:app

功能

提供的工具

以下是 MCP 提供的主要功能：

内容管理

• 创建内容：通过调用 create_content 方法，可以生成新的内容。
• 更新内容：使用 update_content 方法来修改现有内容。

媒体管理

• 上传媒体：利用 upload_media 方法将文件上传到系统。支持的格式包括 JPEG、PNG 和 WebP。

使用与大语言模型 (LLM)

此 MCP 设计用于与支持 Model Context Protocol 的大型语言模型一起使用。它允许 LLM 管理 DevHub CMS 中的内容，而无需直接集成 API。

测试

此包包含一个测试套件，通过模拟请求到 DevHub API 进行功能测试，无需实际调用 API。

执行测试

首先安装测试依赖项：

uv pip install -e ".[test]"

运行测试：

uv run pytest

获取详细输出和覆盖报告：

uv run pytest -v --cov=devhub_cms_mcp

测试结构

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