herohunt-ai/herohunt-mcp

herohunt-mcp 是做什么的？

用于 HeroHunt 人才搜索 API 的 MCP 服务器。可从任何兼容 MCP 的 AI 代理中搜索 LinkedIn、GitHub 和 StackOverflow 上的人才。

快速开始

选项 1：远程 URL（推荐）

Claude Desktop、Cursor 及多数现代 MCP 客户端直接支持远程 HTTP 端点。无需安装任何软件包。

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer 你的API密钥"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)：

{
  "mcpServers": {
    "herohunt-people-search": {
      "url": "https://api.herohunt.ai/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer 你的API密钥"
      }
    }
  }
}

选项 2：stdio（通过 npx）

适用于仅支持 stdio 传输的 MCP 客户端：

{
  "mcpServers": {
    "herohunt-people-search": {
      "command": "npx",
      "args": ["-y", "herohunt-mcp"],
      "env": {
        "HEROHUNT_API_KEY": "你的API密钥"
      }
    }
  }
}

获取 API 密钥

在 herohunt.ai/app/api/sign-up 注册以获取你的 API 密钥。

工具

工具	类型	描述
people_search	写入	使用自然语言搜索人物简介。每个预留位置消耗 1 个积分。
people_search_paginate	读取	获取已有搜索的更多结果。除非启用丰富化，否则免费。
account_usage_get	读取	获取套餐、积分、速率限制信息。免费。
account_searches_list	读取	列出过往搜索记录。免费。
account_upgrade_link	读取	获取套餐升级链接。免费。
account_billing_portal_link	读取	获取 Stripe 账单门户链接。免费。
api_keys_list	读取	列出 API 密钥前缀与作用域。免费。
api_keys_create	写入	创建新的 API 密钥。
api_keys_rotate	写入	轮换现有的 API 密钥。
api_keys_revoke	写入	永久撤销一个 API 密钥。

示例

连接后，向你的 AI 代理提问：

"使用 HeroHunt 帮我找到 5 位柏林的高级 Go 工程师，并总结前 3 位。"

代理会使用自然语言查询调用 people_search，接收结构化的简介数据（姓名、头衔、公司、地点、技能、平台链接），并总结结果。

要获取联系方式，可以提问：

"用邮箱和电话号码丰富结果。"

代理将调用 people_search_paginate，参数为 enrich: true。

环境变量

变量	必需	默认值	描述
HEROHUNT_API_KEY	是	-	你的 People Search API 密钥
HEROHUNT_MCP_URL	否	https://api.herohunt.ai/api/v1/mcp	覆盖 MCP 端点 URL

链接

• API 文档
• 注册
• 控制面板

许可证

MIT