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

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.

Sample Windows Settings File

Sample MacOS/Linux configuration file

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