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: Optimized Memory MCP Server V2

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