DevHub CMS MCP

DevHub CMS MCP

DevHub CMS システムのコンテンツを管理するための、Model Context Protocol（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のグローバル環境または個々のプロジェクトに追加することで、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 経由でのインストール

Smithery経由で、Claude Desktop 用の DevHub CMS MCP を自動的にインストールするには、次のようにします。

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

ローカル開発

リポジトリ（またはフォーク）をクローンする

git clone [email protected]:devhub/devhub-cms-mcp.git

Claude Desktop の手動設定

ローカル開発でこのサーバーを Claude Desktop アプリと使用するには、claude_desktop_config.jsonの「mcpServers」セクションに次の設定を追加します。

{
    "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)：URL から DevHub のサイト ID と詳細情報を取得します。サイト 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 は、Model Context Protocol に対応する大規模言語モデルでの使用を想定しています。LLM にネイティブな API アクセスを統合しなくても、DevHub CMS のコンテンツを管理できます。

テスト

このパッケージには、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 統合エンドポイントのテスト