github-talent-mcp 0.2.0__tar.gz → 0.3.0__tar.gz

{github_talent_mcp-0.2.0/src/github_talent_mcp.egg-info → github_talent_mcp-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-talent-mcp
-Version: 0.2.0
+Version: 0.3.0
 Summary: MCP server for searching, scoring, and ranking GitHub developers for technical recruiting
 Author: Carolina Cherry
 License: MIT
@@ -33,10 +33,13 @@ Dynamic: license-file
 [![Python 3.14+](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org)
 [![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-8A2BE2)](https://modelcontextprotocol.io)
 [![Claude](https://img.shields.io/badge/Built_for-Claude_by_Anthropic-d4a373)](https://claude.ai)
+[![GitHub Copilot](https://img.shields.io/badge/Works_with-GitHub_Copilot-8957E5?logo=githubcopilot&logoColor=white)](https://github.com/features/copilot)
 [![GitHub API](https://img.shields.io/badge/GitHub-REST_API_v3-181717?logo=github)](https://docs.github.com/en/rest)
 
 MCP server that searches, scores, and ranks GitHub developers for technical recruiting.
 
+Works with **Claude** (Code & Desktop) and **GitHub Copilot** (CLI & desktop app) — any MCP client that speaks stdio.
+
 ## Demo
 
 https://github.com/user-attachments/assets/b2dbe9e0-26ee-4849-861a-4b5cb268facc
@@ -149,13 +152,7 @@ Restart Claude Desktop. The tools will appear in the toolbox icon.
 
 The [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) and the [GitHub Copilot app](https://github.com/features/ai/github-app) share one MCP config, so a single setup covers both.
 
-One command (Copilot CLI):
-
-```bash
-copilot mcp add github-talent -e GITHUB_TOKEN=$GITHUB_TOKEN -- uvx github-talent-mcp
-```
-
-Or add it manually to `~/.copilot/mcp-config.json`:
+Add it to `~/.copilot/mcp-config.json` (global), or commit a `.copilot/mcp-config.json` in your repo — the Copilot app picks that up automatically:
 
 ```json
 {
@@ -175,7 +172,7 @@ Or add it manually to `~/.copilot/mcp-config.json`:
 
 Export your token first (`export GITHUB_TOKEN=ghp_xxxxxxxxxxxx`) — Copilot only inherits `PATH`, so the `${GITHUB_TOKEN}` reference reads it from your shell. If `uvx` isn't on your `PATH`, use its absolute path as `command`.
 
-The **Copilot app** picks up this same config; it also syncs a repo's `.copilot/mcp-config.json` automatically and lets you add servers under Settings → MCP. Verify with `copilot mcp list` (terminal) or `/mcp show` (in a Copilot session) — you should see 8 tools under `github-talent`.
+The **Copilot app** reads this same config and also lets you add servers under Settings → MCP. In a Copilot CLI session, run `/mcp add` to register interactively or `/mcp show` to verify — you should see 8 tools under `github-talent`.
 
 ## Try It
 

{github_talent_mcp-0.2.0 → github_talent_mcp-0.3.0}/README.md

@@ -4,10 +4,13 @@
 [![Python 3.14+](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org)
 [![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-8A2BE2)](https://modelcontextprotocol.io)
 [![Claude](https://img.shields.io/badge/Built_for-Claude_by_Anthropic-d4a373)](https://claude.ai)
+[![GitHub Copilot](https://img.shields.io/badge/Works_with-GitHub_Copilot-8957E5?logo=githubcopilot&logoColor=white)](https://github.com/features/copilot)
 [![GitHub API](https://img.shields.io/badge/GitHub-REST_API_v3-181717?logo=github)](https://docs.github.com/en/rest)
 
 MCP server that searches, scores, and ranks GitHub developers for technical recruiting.
 
+Works with **Claude** (Code & Desktop) and **GitHub Copilot** (CLI & desktop app) — any MCP client that speaks stdio.
+
 ## Demo
 
 https://github.com/user-attachments/assets/b2dbe9e0-26ee-4849-861a-4b5cb268facc
@@ -120,13 +123,7 @@ Restart Claude Desktop. The tools will appear in the toolbox icon.
 
 The [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) and the [GitHub Copilot app](https://github.com/features/ai/github-app) share one MCP config, so a single setup covers both.
 
-One command (Copilot CLI):
-
-```bash
-copilot mcp add github-talent -e GITHUB_TOKEN=$GITHUB_TOKEN -- uvx github-talent-mcp
-```
-
-Or add it manually to `~/.copilot/mcp-config.json`:
+Add it to `~/.copilot/mcp-config.json` (global), or commit a `.copilot/mcp-config.json` in your repo — the Copilot app picks that up automatically:
 
 ```json
 {
@@ -146,7 +143,7 @@ Or add it manually to `~/.copilot/mcp-config.json`:
 
 Export your token first (`export GITHUB_TOKEN=ghp_xxxxxxxxxxxx`) — Copilot only inherits `PATH`, so the `${GITHUB_TOKEN}` reference reads it from your shell. If `uvx` isn't on your `PATH`, use its absolute path as `command`.
 
-The **Copilot app** picks up this same config; it also syncs a repo's `.copilot/mcp-config.json` automatically and lets you add servers under Settings → MCP. Verify with `copilot mcp list` (terminal) or `/mcp show` (in a Copilot session) — you should see 8 tools under `github-talent`.
+The **Copilot app** reads this same config and also lets you add servers under Settings → MCP. In a Copilot CLI session, run `/mcp add` to register interactively or `/mcp show` to verify — you should see 8 tools under `github-talent`.
 
 ## Try It
 

{github_talent_mcp-0.2.0 → github_talent_mcp-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-talent-mcp"
-version = "0.2.0"
+version = "0.3.0"
 description = "MCP server for searching, scoring, and ranking GitHub developers for technical recruiting"
 readme = "README.md"
 license = {text = "MIT"}

{github_talent_mcp-0.2.0 → github_talent_mcp-0.3.0}/src/github_talent_mcp/github_client.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import asyncio
 import logging
 import os
 import time
@@ -54,6 +55,59 @@ class GitHubClient:
             reset = resp.headers.get("X-RateLimit-Reset", "unknown")
             log.warning(f"Rate limit low: {remaining} remaining, resets at {reset}")
 
+    # -- Request wrapper with rate-limit backoff --
+
+    async def _get(
+        self,
+        url: str,
+        *,
+        params: dict | None = None,
+        headers: dict | None = None,
+        max_retries: int = 3,
+    ) -> httpx.Response:
+        """GET with backoff on GitHub rate limits (primary + secondary) and 5xx.
+
+        Respects Retry-After and X-RateLimit-Reset so a broad sourcing run paces
+        itself instead of erroring out mid-job. Each wait is capped (60s) so an
+        exhausted hourly quota fails fast rather than hanging the session.
+        """
+        resp = await self._client.get(url, params=params, headers=headers)
+        for attempt in range(max_retries):
+            if not self._should_retry(resp):
+                return resp
+            delay = self._retry_after_seconds(resp, attempt)
+            log.warning(
+                f"GitHub {resp.status_code} on {url} — backing off {delay:.0f}s "
+                f"(retry {attempt + 1}/{max_retries})"
+            )
+            await asyncio.sleep(delay)
+            resp = await self._client.get(url, params=params, headers=headers)
+        return resp
+
+    @staticmethod
+    def _should_retry(resp: httpx.Response) -> bool:
+        if resp.status_code >= 500:
+            return True
+        if resp.status_code in (403, 429):
+            # Secondary limit sends Retry-After; primary limit zeroes Remaining.
+            if resp.headers.get("Retry-After"):
+                return True
+            if resp.headers.get("X-RateLimit-Remaining") == "0":
+                return True
+        return False
+
+    @staticmethod
+    def _retry_after_seconds(resp: httpx.Response, attempt: int) -> float:
+        retry_after = resp.headers.get("Retry-After", "")
+        if retry_after.isdigit():
+            return min(float(retry_after), 60.0)
+        if resp.headers.get("X-RateLimit-Remaining") == "0":
+            reset = resp.headers.get("X-RateLimit-Reset", "")
+            if reset.isdigit():
+                wait = float(reset) - time.time()
+                return min(max(wait, 0.0), 60.0) + 1.0
+        return min(2.0 ** attempt, 30.0)
+
     # -- API methods --
 
     async def search_users(
@@ -81,7 +135,7 @@ class GitHubClient:
         # Recent activity should be verified via get_developer_profile.
 
         q = " ".join(parts)
-        resp = await self._client.get(
+        resp = await self._get(
             "/search/users",
             params={"q": q, "per_page": per_page, "page": page, "sort": "followers", "order": "desc"},
         )
@@ -94,7 +148,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(f"/repos/{owner}/{repo}")
+        resp = await self._get(f"/repos/{owner}/{repo}")
         self._check_rate_limit(resp)
         resp.raise_for_status()
         data = resp.json()
@@ -106,7 +160,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(f"/users/{username}")
+        resp = await self._get(f"/users/{username}")
         self._check_rate_limit(resp)
         resp.raise_for_status()
         data = resp.json()
@@ -118,7 +172,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(
+        resp = await self._get(
             f"/users/{username}/repos",
             params={"per_page": per_page, "sort": "pushed", "direction": "desc", "type": "owner"},
         )
@@ -133,7 +187,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(f"/repos/{owner}/{repo}/languages")
+        resp = await self._get(f"/repos/{owner}/{repo}/languages")
         self._check_rate_limit(resp)
         resp.raise_for_status()
         data = resp.json()
@@ -147,7 +201,7 @@ class GitHubClient:
             return cached
         all_events: list[dict] = []
         for page in range(1, max_pages + 1):
-            resp = await self._client.get(
+            resp = await self._get(
                 f"/users/{username}/events/public",
                 params={"per_page": 100, "page": page},
             )
@@ -170,7 +224,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(
+        resp = await self._get(
             "/search/commits",
             params={
                 "q": f"author:{username} user:{username} committer-date:>={since_date}",
@@ -189,7 +243,7 @@ class GitHubClient:
         cached = self._cache_get(cache_key)
         if cached is not None:
             return cached
-        resp = await self._client.get(
+        resp = await self._get(
             "/search/issues",
             params={
                 "q": f"author:{username} type:pr created:>={since_date}",
@@ -208,7 +262,7 @@ class GitHubClient:
         if cached is not None:
             return cached
         try:
-            resp = await self._client.get(
+            resp = await self._get(
                 f"/repos/{username}/{username}/readme",
                 headers={"Accept": "application/vnd.github.raw+json"},
             )
@@ -224,7 +278,7 @@ class GitHubClient:
     async def get_repo_contributors(
         self, owner: str, repo: str, per_page: int = 30,
     ) -> list[dict]:
-        resp = await self._client.get(
+        resp = await self._get(
             f"/repos/{owner}/{repo}/contributors",
             params={"per_page": per_page},
         )

{github_talent_mcp-0.2.0 → github_talent_mcp-0.3.0/src/github_talent_mcp.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-talent-mcp
-Version: 0.2.0
+Version: 0.3.0
 Summary: MCP server for searching, scoring, and ranking GitHub developers for technical recruiting
 Author: Carolina Cherry
 License: MIT
@@ -33,10 +33,13 @@ Dynamic: license-file
 [![Python 3.14+](https://img.shields.io/badge/Python-3.14+-blue.svg)](https://www.python.org)
 [![MCP](https://img.shields.io/badge/MCP-Model_Context_Protocol-8A2BE2)](https://modelcontextprotocol.io)
 [![Claude](https://img.shields.io/badge/Built_for-Claude_by_Anthropic-d4a373)](https://claude.ai)
+[![GitHub Copilot](https://img.shields.io/badge/Works_with-GitHub_Copilot-8957E5?logo=githubcopilot&logoColor=white)](https://github.com/features/copilot)
 [![GitHub API](https://img.shields.io/badge/GitHub-REST_API_v3-181717?logo=github)](https://docs.github.com/en/rest)
 
 MCP server that searches, scores, and ranks GitHub developers for technical recruiting.
 
+Works with **Claude** (Code & Desktop) and **GitHub Copilot** (CLI & desktop app) — any MCP client that speaks stdio.
+
 ## Demo
 
 https://github.com/user-attachments/assets/b2dbe9e0-26ee-4849-861a-4b5cb268facc
@@ -149,13 +152,7 @@ Restart Claude Desktop. The tools will appear in the toolbox icon.
 
 The [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) and the [GitHub Copilot app](https://github.com/features/ai/github-app) share one MCP config, so a single setup covers both.
 
-One command (Copilot CLI):
-
-```bash
-copilot mcp add github-talent -e GITHUB_TOKEN=$GITHUB_TOKEN -- uvx github-talent-mcp
-```
-
-Or add it manually to `~/.copilot/mcp-config.json`:
+Add it to `~/.copilot/mcp-config.json` (global), or commit a `.copilot/mcp-config.json` in your repo — the Copilot app picks that up automatically:
 
 ```json
 {
@@ -175,7 +172,7 @@ Or add it manually to `~/.copilot/mcp-config.json`:
 
 Export your token first (`export GITHUB_TOKEN=ghp_xxxxxxxxxxxx`) — Copilot only inherits `PATH`, so the `${GITHUB_TOKEN}` reference reads it from your shell. If `uvx` isn't on your `PATH`, use its absolute path as `command`.
 
-The **Copilot app** picks up this same config; it also syncs a repo's `.copilot/mcp-config.json` automatically and lets you add servers under Settings → MCP. Verify with `copilot mcp list` (terminal) or `/mcp show` (in a Copilot session) — you should see 8 tools under `github-talent`.
+The **Copilot app** reads this same config and also lets you add servers under Settings → MCP. In a Copilot CLI session, run `/mcp add` to register interactively or `/mcp show` to verify — you should see 8 tools under `github-talent`.
 
 ## Try It
 

{github_talent_mcp-0.2.0 → github_talent_mcp-0.3.0}/src/github_talent_mcp.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ src/github_talent_mcp/tools/search.py
 tests/test_bulk.py
 tests/test_compare.py
 tests/test_outreach.py
+tests/test_rate_limit.py
 tests/test_score_jd.py
 tests/test_scoring.py
 tests/test_search.py

github_talent_mcp-0.3.0/tests/test_rate_limit.py

@@ -0,0 +1,93 @@
+import asyncio
+import time
+from unittest.mock import AsyncMock
+
+import httpx
+import pytest
+
+from github_talent_mcp.github_client import GitHubClient
+
+
+def _resp(status: int, headers: dict | None = None) -> httpx.Response:
+    return httpx.Response(
+        status,
+        headers=headers or {},
+        request=httpx.Request("GET", "https://api.github.com/x"),
+    )
+
+
+def _client_with(responses: list[httpx.Response]) -> GitHubClient:
+    client = GitHubClient.__new__(GitHubClient)
+    client._client = type("FakeHTTP", (), {})()
+    client._client.get = AsyncMock(side_effect=list(responses))
+    return client
+
+
+@pytest.fixture(autouse=True)
+def no_sleep(monkeypatch):
+    """Capture backoff durations without actually waiting."""
+    slept: list[float] = []
+
+    async def fake_sleep(delay):
+        slept.append(delay)
+
+    monkeypatch.setattr(asyncio, "sleep", fake_sleep)
+    return slept
+
+
+@pytest.mark.asyncio
+async def test_retries_on_primary_rate_limit(no_sleep):
+    reset = str(int(time.time()) + 2)
+    client = _client_with([
+        _resp(403, {"X-RateLimit-Remaining": "0", "X-RateLimit-Reset": reset}),
+        _resp(200),
+    ])
+    resp = await client._get("/x")
+    assert resp.status_code == 200
+    assert client._client.get.await_count == 2
+    assert no_sleep and no_sleep[0] <= 61.0
+
+
+@pytest.mark.asyncio
+async def test_retries_on_secondary_rate_limit_retry_after(no_sleep):
+    client = _client_with([
+        _resp(429, {"Retry-After": "3"}),
+        _resp(200),
+    ])
+    resp = await client._get("/x")
+    assert resp.status_code == 200
+    assert no_sleep == [3.0]
+
+
+@pytest.mark.asyncio
+async def test_retries_on_5xx(no_sleep):
+    client = _client_with([_resp(502), _resp(200)])
+    resp = await client._get("/x")
+    assert resp.status_code == 200
+    assert client._client.get.await_count == 2
+
+
+@pytest.mark.asyncio
+async def test_no_retry_on_404(no_sleep):
+    client = _client_with([_resp(404)])
+    resp = await client._get("/x")
+    assert resp.status_code == 404
+    assert client._client.get.await_count == 1
+    assert no_sleep == []
+
+
+@pytest.mark.asyncio
+async def test_no_retry_on_403_with_quota_remaining(no_sleep):
+    # A 403 that is NOT a rate limit (e.g. permissions) should not retry.
+    client = _client_with([_resp(403, {"X-RateLimit-Remaining": "4999"})])
+    resp = await client._get("/x")
+    assert resp.status_code == 403
+    assert client._client.get.await_count == 1
+
+
+@pytest.mark.asyncio
+async def test_gives_up_after_max_retries(no_sleep):
+    client = _client_with([_resp(403, {"Retry-After": "1"})] * 10)
+    resp = await client._get("/x", max_retries=3)
+    assert resp.status_code == 403
+    assert client._client.get.await_count == 4  # initial + 3 retries