DevHub

DevHub CMS MCP

Tích hợp Model Context Protocol (MCP) để quản lý nội dung trong hệ thống DevHub CMS.

Cài đặt

Bạn cần cài đặt trình quản lý gói uv trên hệ thống cục bộ của mình.

Cấu hình thủ công cho Claude Desktop

Để sử dụng máy chủ này với ứng dụng Claude Desktop, hãy thêm cấu hình sau vào phần "mcpServers" trong claude_desktop_config.json của bạn:

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

Sau khi cập nhật cấu hình, hãy khởi động lại Claude Desktop.

Cấu hình thủ công cho Cursor

MCP này cũng có thể được sử dụng trong Cursor với cấu hình tương tự như trên được thêm vào môi trường toàn cục Cursor của bạn hoặc vào từng dự án riêng lẻ.

Ví dụ tại đây

Cài đặt qua Claude Code

Dòng lệnh của Claude Code hỗ trợ cài đặt MCP.

Bạn có thể thêm devhub-cms-mcp bằng cách cập nhật các biến môi trường bên dưới

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

Cài đặt qua Smithery

Để cài đặt DevHub CMS MCP cho Claude Desktop tự động qua Smithery:

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

Phát triển cục bộ

Sao chép kho lưu trữ (hoặc bản fork của bạn)

git clone git@github.com:devhub/devhub-cms-mcp.git

Cấu hình thủ công cho Claude Desktop

Để sử dụng máy chủ này với ứng dụng Claude Desktop cho phát triển cục bộ, hãy thêm cấu hình sau vào phần "mcpServers" trong claude_desktop_config.json của bạn:

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

Sau khi cập nhật cấu hình, hãy khởi động lại Claude Desktop.

Cấu hình để chạy trực tiếp với uv

MCP này yêu cầu thiết lập các biến môi trường sau:

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

Sau đó chạy MCP

uv run main.py

Công cụ có sẵn

MCP này cung cấp các công cụ sau để tương tác với DevHub CMS:

Quản lý doanh nghiệp và địa điểm

• get_businesses(): Lấy tất cả doanh nghiệp trong tài khoản DevHub. Trả về danh sách doanh nghiệp với ID và tên của chúng.
• get_locations(business_id): Lấy tất cả địa điểm cho một doanh nghiệp cụ thể. Trả về thông tin chi tiết về địa điểm bao gồm địa chỉ, tọa độ và URL.
• get_hours_of_operation(location_id, hours_type='primary'): Lấy giờ hoạt động cho một địa điểm DevHub cụ thể. Trả về danh sách có cấu trúc các khung giờ cho mỗi ngày trong tuần.
• update_hours(location_id, new_hours, hours_type='primary'): Cập nhật giờ hoạt động cho một địa điểm DevHub.
• get_nearest_location(business_id, latitude, longitude): Tìm địa điểm DevHub gần nhất dựa trên tọa độ địa lý.
• site_from_url(url): Lấy ID trang web DevHub và chi tiết từ một URL. Trả về ID trang web, URL và các ID địa điểm liên quan.

Quản lý nội dung

• get_blog_post(post_id): Truy xuất một bài đăng blog theo ID, bao gồm tiêu đề, ngày tháng và nội dung HTML.
• create_blog_post(site_id, title, content): Tạo một bài đăng blog mới. Nội dung phải ở định dạng HTML và không nên bao gồm thẻ H1.
• update_blog_post(post_id, title=None, content=None): Cập nhật tiêu đề và/hoặc nội dung của một bài đăng blog hiện có.

Quản lý phương tiện

• upload_image(base64_image_content, filename): Tải lên một hình ảnh vào thư viện phương tiện DevHub. Hỗ trợ định dạng webp, jpeg và png. Hình ảnh phải được cung cấp dưới dạng chuỗi mã hóa base64.

Sử dụng với LLM

MCP này được thiết kế để sử dụng với các Mô hình Ngôn ngữ Lớn hỗ trợ Model Context Protocol. Nó cho phép LLM quản lý nội dung trong DevHub CMS mà không cần truy cập API trực tiếp được tích hợp sẵn trong LLM.

Kiểm thử

Gói này bao gồm một bộ kiểm thử với các yêu cầu giả lập đến API DevHub, cho phép bạn kiểm tra chức năng mà không cần thực hiện các cuộc gọi API thực tế.

Chạy kiểm thử

Để chạy kiểm thử, trước tiên hãy cài đặt gói với các phụ thuộc kiểm thử:

uv pip install -e ".[test]"

Chạy kiểm thử bằng pytest:

uv run pytest

Để có đầu ra chi tiết hơn và thông tin về phạm vi kiểm thử:

uv run pytest -v --cov=devhub_cms_mcp

Cấu trúc kiểm thử

• tests/devhub_cms_mcp/test_mcp_integration.py: Kiểm thử cho các điểm cuối tích hợp MCP