hubble_mcp

⚠️ Caution

Currently available only in on-premise VPN environments.

Since the API may occasionally fail, you need to check whether the data response was received normally.
(If you click on the message that Claude used as a tool, you can check the API response message.)

set-up-your-environment

• Install Claude Desktop

  • https://claude.ai/download

• Install uv (hubble MCP Server is written in python) - https://modelcontextprotocol.io/quickstart/server#set-up-your-environment

  • Windows

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

    If the uv command is blocked in real-time monitoring of some security programs, please stop real-time monitoring or exclude the file in question.

  • MacOS/Linux

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

• Download Hubble MCP Server

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

    • After downloading the zip file, unzip it (requires the corresponding path in the settings file below)

    • Use the latest version

• Issue HUBBLE_API_KEY

Related MCP server: PostHog MCP Server

Setting up the claude_desktop_config.json file

• Claude Desktop > File > Preferences (Ctrl + ,) > Developer > Edit Preferences

  • After modifying the json file, you need to restart Claude Desktop > File > Exit!

• If you are on Mac, you need the absolute path to the uv executable file, see the Mac sample below.

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

Sample Windows Settings File

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

Sample MacOS/Linux configuration file

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

Description of tools (functions) provided ( https://hubble-data-api.ascentlab.io/ )

• get_search_path: Search Path API

• get_keyword_info: Search volume for the keyword (monthly search volume), summary of feature types appearing in Google SERP, search intent (INCT), gender/age ratio for Korea

• get_graph_info: Relationship information between keywords

• crawl_google_serp: Google SERP API

• crawl_web_page: General web page collection API

• crawl_google_suggest_extension: Google Suggest API

• crawl_google_trends: Google Trends API