githunt-mcp

githunt-mcp

一个 MCP 服务，让你的 AI 助手能以招聘人员的视角查看 GitHub。它封装了 GitHunt 的 API，让 Claude、Cursor 和其他 MCP 客户端可以搜索经过预索引的 GitHub 开发者库、查找排名靠前的个人资料，并对候选人进行深入的 AI 分析——这一切都可以通过聊天提示词完成。

询问 “在柏林寻找熟悉 Go 和 Kubernetes 的后端工程师”，即可获得按匹配度排序和评分的候选人名单，并附带活跃度信号和联系信息。

想要零配置？ GitHunt 还提供托管的 MCP 服务：https://mcp.githunt.ai/mcp。将它添加为 Claude 中的自定义连接器（Settings -> Connectors），或在你的客户端中将其添加为远程 MCP 服务，然后使用 GitHunt 账号登录即可——无需 API 密钥或本地进程。此软件包是可自托管的（stdio）替代方案。

快速开始

1. 从你的 GitHunt 账号获取 API 密钥。

2. 运行服务：

   GITHUNT_API_KEY=your-key-here npx githunt-mcp
   

3. 将其接入你的客户端（见下文），然后直接提问。

环境变量

变量	必填	说明
GITHUNT_API_KEY	是	你的 GitHunt API 密钥
GITHUNT_API_URL	否	API 基础 URL（默认值为 https://api.githunt.ai）

Claude Code

claude mcp add githunt -e GITHUNT_API_KEY=your-key-here -- npx githunt-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "githunt": {
      "command": "npx",
      "args": ["githunt-mcp"],
      "env": {
        "GITHUNT_API_KEY": "your-key-here"
      }
    }
  }
}

任何支持 stdio 的 MCP 客户端都可以用相同方式运行：在环境中设置 GITHUNT_API_KEY，然后运行 npx githunt-mcp。

试试看

连接后，像平常一样向助手提问：

• “在华沙寻找熟悉 React 和 TypeScript 的资深前端开发者。”
• “给我看看波兰有 5 年以上 GitHub 经验且可受聘的 DevOps 工程师。”
• “给我这个搜索结果中的下一批 25 位候选人。”（通过 offset 分页）
• “调出 octocat 的 GitHunt 个人资料。”
• “深入分析 torvalds——熟练程度、最适合的职位，以及任何公开邮箱。”
• “搜索旧金山的 ML 工程师，然后分析排名前三的候选人。”

工具

工具	功能	速度
search_developers	按 location、role、skills、languages 等条件搜索 GitHunt 的预索引开发者库。返回按匹配度排序的候选人，并附上评分、活跃度和联系信息。通过 offset 分页（0-200）。返回 Markdown 表格和结构化 JSON。如果某个地点没有匹配结果，则会推荐相似的受支持地点，而不是返回空页面。	快速（从开发者库返回，无需实时抓取）
get_developer	根据 login/username 获取单个开发者的排名个人资料：总体、个人资料、技术栈和活跃度评分、经验、提交活动、热门仓库及联系信息。	快速（优先使用缓存）
analyze_profile	根据实时 GitHub 数据对个人资料进行深入 AI 分析：熟练程度、最适合的职位，以及提取的邮箱。用于评估已进入候选名单的候选人。	较慢（实时抓取）

支持的 role 值： fullstack、frontend、backend、mobile、 devops、ai-engineer、ai-orchestrator、ml-engineer、data-scientist、 data-engineer、security、cloud、blockchain、embedded、gamedev、 ios-developer、android-developer、sre、platform-engineer、 qa-engineer、solutions-architect、cto、vp-engineering、 head-engineering、engineering-manager、tech-lead、product-manager、 director-engineering。

技能会通过同义词匹配（k8s -> kubernetes），地点会进行规范化处理（SF、NYC、UK、Warszawa）。

完整 API 参考：https://docs.githunt.ai

评分

每位候选人都有一个综合评分，由三个维度构成，均可通过 get_developer 查看：

• 个人资料评分 - 简介、资历信号和账号成熟度。
• 技术栈评分 - 其使用的语言和代码仓库与所需技能及职位的匹配程度。
• 活跃度评分 - 公开贡献的近期情况和数量（提交、频率、提交消息质量）。

search_developers 会根据与你的查询的匹配度为候选人排序；analyze_profile 会基于最新的 GitHub 数据重新计算技能水平和职位匹配度。

配额

请求会计入你的 GitHunt 套餐配额。每个响应都会包含你的当前用量（本月的 已用量 / 限额），达到上限时会返回 quota_exceeded 错误。请参阅你的账号了解套餐限额。

局限性与负责任的使用

GitHunt 读取的是公开的 GitHub 活动，这是技术工作的有力证据，但并不能体现全貌：

• 它无法看到私有代码仓库、内部及企业贡献——许多优秀工程师的公开资料并不活跃。
• 候选人池经过预先索引，因此可能不包含刚创建或很少活跃的账号；analyze_profile 会获取特定人员的实时数据。
• 公开活动信号可能会受到地域、雇主和职业阶段的影响。

请将其用作线索生成器，而非自动筛选器。评分应作为人工沟通的起点，而不是招聘决策。GitHub 并不能代表工程师的全部。

贡献

欢迎提交问题和拉取请求。提交大型 PR 前，请先创建问题描述变更。API 行为和端点详情请参阅 https://docs.githunt.ai。

许可证

MIT - 请参阅 LICENSE。