用途

GitHunt MCP 是一个 MCP（Model Context Protocol）服务器，为 AI 助手提供“招聘者视角”的 GitHub 检索能力。它封装 GitHunt 的 API，使 Claude、Cursor 及其他 MCP 客户端能够从聊天提示中直接搜索预索引的 GitHub 开发者库、查看带评分的候选人档案，并对候选人运行深度 AI 分析。

主要能力

搜索开发者：按地点、角色和技能检索预索引的开发者池，返回按匹配度排序的候选人名单。
查看排名档案：通过 get_developer 获取单个开发者的档案信息。
深度 AI 分析：通过 analyze_profile 针对特定候选人重新计算技能熟练度和角色匹配度，并基于最新 GitHub 数据进行分析。
评分体系：每位候选人带有综合评分，由三个维度构成：
- 档案分（Profile score）：简介、资历信号和账户成熟度。
- 技术栈分（Tech-stack score）：语言和仓库与所请求技能及角色的匹配程度。
- 活跃度分（Activity score）：公开贡献的近期性和数量（提交、频率、提交信息质量）。
技能与地点归一化：技能匹配支持同义词（如 k8s -> kubernetes），地点会被规范化（如 SF、NYC、UK、Warszawa）。
分页：通过 offset 参数获取搜索结果的后续候选人。
联系方式发现：结果中包含活跃度信号和联系信息。

使用方式

托管 MCP 服务器（零配置）

GitHunt 提供托管 MCP 服务器：https://mcp.githunt.ai/mcp 。在 Claude 中作为自定义连接器添加（Settings -> Connectors），或在客户端中作为远程 MCP 服务器添加，并使用 GitHunt 账户登录——无需 API 密钥或本地进程。

自托管（stdio）

本包是自托管的 stdio 替代方案。

从 GitHunt 账户获取 API 密钥。
运行服务器：

GITHUNT_API_KEY=your-key-here npx githunt-mcp

接入客户端：

添加到 claude_desktop_config.json：

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

添加到 .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。

环境变量

GITHUNT_API_KEY：GitHunt API 密钥（必填）。

提示示例

连接后，可用自然语言提示助手：

“Find senior frontend developers in Warsaw who know React and TypeScript.”
“Show me hireable DevOps engineers in Poland with 5+ years on GitHub.”
“Give me the next 25 candidates for that search.”（通过 offset 分页）
“Pull up octocat's GitHunt profile.”
“Do a deep analysis of torvalds - proficiency, best-fit roles, any public emails.”
“Search for ML engineers in San Francisco, then analyze your top 3.”

支持的角色值

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。

API 参考

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

适用场景

技术招聘中的候选人线索发现与初步筛选。
按地点、角色、技能组合快速生成候选人短名单。
对特定候选人进行基于公开 GitHub 数据的技能与角色匹配分析。

限制与负责任使用

GitHunt 读取公开 GitHub 活动，这是技术工作的有力证据，但远非全貌：

无法看到私有仓库、内部和企业贡献——许多优秀工程师的公开档案并不活跃。
候选人池是预索引的，因此全新或极少活跃的账户可能缺失；analyze_profile 会为特定个人获取实时数据。
公开活动信号可能因地域、雇主和职业阶段而产生偏差。

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

配额

请求会消耗 GitHunt 套餐配额。每个响应都包含当前用量（当月 used / limit），配额超限时会返回 quota_exceeded 错误。套餐限制请查看账户。

贡献与许可

欢迎提交 issue 和 pull request。发送大型 PR 前请先开 issue 描述变更。API 行为和端点详情见 https://docs.githunt.ai 。

MIT 许可——见 LICENSE。

githunt-mcp

工具介绍

用途