githunt-mcp

githunt-mcp

AI アシスタントに、GitHub を採用担当者の視点で見られるようにする MCP サーバーです。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 に詳しい、ワルシャワのシニアフロントエンド開発者を探して。」
• 「GitHub で 5 年以上の経験がある、ポーランドの採用可能な DevOps エンジニアを見せて。」
• 「その検索結果の次の候補者を 25 人表示して。」（offset によるページング）
• 「octocat の GitHunt プロフィールを表示して。」
• 「torvalds を詳しく分析して。習熟度、最適な職種、公開メールアドレスの有無を教えて。」
• 「サンフランシスコで ML エンジニアを検索して、上位 3 人を分析して。」

ツール

ツール	機能	速度
search_developers	location、role、skills、languages などを条件に、GitHunt の事前にインデックス化されたプールを検索します。適合度、スコア、活動状況、連絡先情報に基づいて候補者をランキング順に返します。offset（0～200）でページングできます。Markdown テーブルと構造化 JSON を返します。場所に一致する結果がない場合は、空のページではなく、対応している類似の場所を提案します。	高速（プールから提供。ライブクロールなし）
get_developer	login／username を指定して、開発者 1 人のランキング付きプロフィールを取得します。総合、プロフィール、技術スタック、活動状況の各スコア、経験、コミット活動、上位リポジトリ、連絡先情報を含みます。	高速（キャッシュ優先）
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 で確認できる3つの指標から算出された総合スコアが付与されます。

• プロフィールスコア - 自己紹介、経験年数を示す情報、アカウントの成熟度。
• 技術スタックのスコア - 言語やリポジトリが、求めるスキルや役割にどれだけ合致しているか。
• アクティビティスコア - 公開された貢献の新しさと量（コミット数、頻度、コミットメッセージの品質）。

search_developers はクエリへの適合度に基づいて候補者プールを順位付けし、analyze_profile は最新の GitHub データを基に、習熟度と役割への適合度を再計算します。

利用枠

リクエストは GitHunt プランの利用枠を消費します。各レスポンスには現在の使用量（月間の used / limit）が含まれ、上限に達すると quota_exceeded エラーが通知されます。プランの上限については、アカウントをご覧ください。

制限事項と責任ある利用

GitHunt が読み取るのは公開されている GitHub アクティビティです。技術的な業務を示す有力な証拠ではありますが、全体像を捉えるものではありません。

• プライベートリポジトリ、社内、企業内での貢献は把握できません。優れたエンジニアの中にも、公開プロフィールでの活動が少ない人は多くいます。
• 候補者プールは事前にインデックス化されているため、新しいアカウントや活動がまれなアカウントは含まれていない場合があります。特定の人物の最新データは analyze_profile が取得します。
• 公開アクティビティの指標は、地域、勤務先、キャリア段階によって偏ることがあります。

これは見込み候補者を見つけるためのツールであり、自動選別ツールではありません。スコアは人との対話を始めるための参考情報として扱い、採用の判断には使用しないでください。GitHub だけでエンジニアの全体像を把握することはできません。

貢献

課題やプルリクエストを歓迎します。大規模なプルリクエストを送る前に、変更内容を説明する課題を作成してください。API の動作やエンドポイントの詳細については、https://docs.githunt.aiをご覧ください。

ライセンス

MIT - LICENSEをご覧ください。