hubble_mcp

⚠️ Precaución

Actualmente disponible solo en entornos VPN locales.

Dado que la API puede fallar ocasionalmente, debe verificar si la respuesta de datos se recibió normalmente.
(Si hace clic en el mensaje que Claude utilizó como herramienta, podrá comprobar el mensaje de respuesta de la API).

configura tu entorno

• Instalar Claude Desktop

  • https://claude.ai/descargar

• Instalar uv (el servidor Hubble MCP está escrito en Python): https://modelcontextprotocol.io/quickstart/server#set-up-your-environment

  • Ventanas

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

    Si el comando uv está bloqueado en el monitoreo en tiempo real de algunos programas de seguridad, detenga el monitoreo en tiempo real o excluya el archivo en cuestión.

  • MacOS/Linux

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

• Descargar el servidor Hubble MCP

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

    • Después de descargar el archivo zip, descomprímalo (requiere la ruta correspondiente en el archivo de configuración a continuación)

    • Utilice la última versión

• Emitir HUBBLE_API_KEY

Related MCP server: PostHog MCP Server

Configuración del archivo claude_desktop_config.json

• Claude Desktop > Archivo > Preferencias (Ctrl + ,) > Desarrollador > Editar preferencias

  • Después de modificar el archivo json, debes reiniciar Claude Desktop > Archivo > Salir.

• Si está en Mac, necesita la ruta absoluta al archivo ejecutable uv, consulte el ejemplo de Mac a continuación.

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

Archivo de configuración de Windows de muestra

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

Ejemplo de archivo de configuración de 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"
      }
    }
  }
}

Descripción de las herramientas (funciones) proporcionadas ( https://hubble-data-api.ascentlab.io/ )

• get_search_path: API de ruta de búsqueda

• get_keyword_info: Volumen de búsqueda de la palabra clave (volumen de búsqueda mensual), resumen de los tipos de características que aparecen en Google SERP, intención de búsqueda (INCT), relación género/edad para Corea

• get_graph_info: Información de relación entre palabras clave

• crawl_google_serp: API SERP de Google

• crawl_web_page: API general de recopilación de páginas web

• crawl_google_suggest_extension: API de sugerencias de Google

• crawl_google_trends: API de tendencias de Google