JinDaGe - devhub-cms-mcp MCP Details

article

README

🚀 DevHub CMS MCP

一个用于管理 DevHub 内容管理系统 (CMS) 的模型上下文协议 (MCP) 集成。它能让您更便捷地操作 DevHub CMS，提升内容管理的效率。

🚀 快速开始

安装

您需要在本地系统上安装 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 进行本地开发，请执行以下步骤：

克隆仓库：

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

安装依赖项：

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 集成端点的测试

devhub-cms-mcp