DevHub MCP Server

DevHub CMS MCP

การผสานรวม Model Context Protocol (MCP) สำหรับจัดการเนื้อหาใน ระบบ DevHub CMS

การติดตั้ง

คุณจะต้องมีตัวจัดการแพ็กเกจ uv ติดตั้งอยู่ในระบบของคุณ

การกำหนดค่า Claude Desktop ด้วยตนเอง

หากต้องการใช้เซิร์ฟเวอร์นี้กับ แอป 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 นี้ยังสามารถใช้ใน 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

หากต้องการติดตั้ง DevHub CMS MCP สำหรับ Claude Desktop โดยอัตโนมัติผ่าน Smithery:

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

การพัฒนาภายในเครื่อง

โคลน repo (หรือ fork ของคุณ)

git clone [email protected]: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_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): รับ ID และรายละเอียดไซต์ DevHub จาก URL ส่งคืน 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

การใช้งานกับ LLM

MCP นี้ออกแบบมาเพื่อใช้กับ Large Language Models ที่รองรับ Model Context Protocol ซึ่งช่วยให้ LLM สามารถจัดการเนื้อหาใน DevHub CMS ได้โดยไม่จำเป็นต้องเข้าถึง API โดยตรงที่ผสานรวมอยู่ใน LLM

การทดสอบ

แพ็กเกจนี้รวมชุดทดสอบพร้อมคำขอจำลองไปยัง 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