hubble_mcp

⚠️注意

現在は社内VPN環境でのみ利用可能です。

APIが失敗することがあるため、データ応答を正常に受信したことを確認する必要があります。
（クロードがツール使用したメッセージをクリックすると、API応答メッセージの確認が可能です。）

set-up-your-environment

• Claude Desktopのインストール

  • https://claude.ai/download

• uvのインストール（hubble MCP ServerはPythonで書かれています） - https://modelcontextprotocol.io/quickstart/server#set-up-your-environment

  • Windows

    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

    一部のセキュリティプログラムのリアルタイム監視でuv命令がブロックされた場合、リアルタイム監視を中断または該当ファイルを除外してください〜

  • MacOS/Linux

    curl -LsSf https://astral.sh/uv/install.sh | sh

• Hubble MCP Server ダウンロード

  • https://github.com/ascentkorea/hubble\_mcp/releases

    • zipファイルダウンロード後、解凍（下記設定ファイルで該当パスが必要）

    • 最新バージョンの使用

• HUBBLE_API_KEY発行

Related MCP server: PostHog MCP Server

claude_desktop_config.jsonファイルの設定

• クラウドデスクトップ>ファイル>設定（Ctrl +、）>開発者>設定の編集

  • jsonファイルを修正した後、クロードデスクトップ>ファイル>シャットダウンを介して再起動が必要です！

• Macの場合、uv実行可能ファイルの絶対パスが必要です、以下のMacサンプルを参照してください

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "<Hubble MCP Server 다운로드후 zip 파일 압축 해제후 data_api.py 파일 있는 경로>",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "<HUBBLE_API_KEY>"
      }
    }
  }
}

Windows設定ファイルのサンプル

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "C:\\Users\\XXXX\\Documents\\hubble\\hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

MacOS/Linux 設定ファイルのサンプル

{
  "mcpServers": {
    "hubble": {
      "command": "/Users/XXX/.local/bin/uv",
      "args": [
          "--directory",
          "/Users/XXX/workspace/hubble/hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

提供されるtool（機能）の説明（ https://hubble-data-api.ascentlab.io/ ）

• get_search_path: 検索パス API

• get_keyword_info: キーワードに対する検索量（月別検索量）、Google SERPに出現する feature type まとめ、検索インテント（INCT）、韓国の場合は性比/年齢比

• get_graph_info：キーワード間の関係情報

• crawl_google_serp：Google SERP API

• crawl_web_page：一般的なウェブページ収集API

• crawl_google_suggest_extension: Google サージェスト API

• crawl_google_trends：GoogleトレンドAPI