Hubble MCP Server

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