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