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

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