Add repository traffic/insights tools (views, clones, referrers, paths)
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 3/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 76/100
Piste de recherche
Commencez par lire les outils existants dans l'ensemble d'outils repos ainsi que les méthodes épinglées de go-github ListTrafficViews, ListTrafficClones, ListTrafficReferrers et ListTrafficPaths. Ajoutez les quatre outils en lecture seule avec les paramètres indiqués et l'exigence de portée au niveau du dépôt, puis vérifiez que views et clones acceptent des ventilations par jour ou par semaine, tandis que referrers et paths ne les acceptent pas.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Describe the feature or problem you'd like to solve
The server has no way to read a repository's traffic/insights data. There are no tools wrapping the four traffic endpoints:
| Proposed tool | GitHub endpoint | Returns |
|---|---|---|
get_traffic_views |
GET /repos/{owner}/{repo}/traffic/views |
Page views + unique visitors (14-day, daily or weekly) |
get_traffic_clones |
GET /repos/{owner}/{repo}/traffic/clones |
Git clones + unique cloners (14-day, daily or weekly) |
get_traffic_referrers |
GET /repos/{owner}/{repo}/traffic/popular/referrers |
Top 10 referring sites |
get_traffic_paths |
GET /repos/{owner}/{repo}/traffic/popular/paths |
Top 10 most-visited paths |
Today an agent can read stars and forks but has no view into whether a repo is actually being visited or cloned, which is the primary signal for measuring adoption and reach of a project. This is a read-only capability.
Proposed solution
Add the four tools above under the existing repos toolset, each ReadOnlyHint: true.
The implementation is thin because the pinned go-github client already exposes all four methods (RepositoriesService.ListTrafficViews, ListTrafficClones, ListTrafficReferrers, ListTrafficPaths), so no new HTTP plumbing is needed. The views/clones tools take an optional per parameter (day | week) mapping to TrafficBreakdownOptions; referrers/paths take just owner/repo.
One note on access: GitHub gates these endpoints behind push access to the repo (for GitHub Apps, the repository Administration: Read permission), so the tools should be annotated to require the repo scope rather than treated as public-read, even though the endpoints exist on public repos.
I'm happy to open a PR for this if the capability is something you'd accept.
Example prompts or workflows (for tools/toolsets only)
- "How many unique visitors and clones did
owner/repoget in the last two weeks?" - "Where is traffic to my repo coming from? Show me the top referrers."
- "Which pages/paths in
owner/repoare people actually viewing?" - "Compare views vs. clones week over week for
owner/repoand tell me if adoption is trending up." - "Build me a weekly adoption report for my repo: stars, forks, views, unique visitors, and clones." (traffic is the missing piece today; stars/forks are already covered)
Additional context
Traffic data has a 14-day rolling retention window on GitHub's side, so these tools are especially useful to agents that snapshot the data on a schedule for longer-term trend tracking.
- Langage dominant
- Go
- Étoiles
- 33.1k
- Forks
- 5k
- Merge moyen
- 2 j 1 h
- PR mergées (30 j)
- 25
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de github/github-mcp-server
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 84/100
github/github-mcp-server#3235 ·
-
enhancement
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
github/github-mcp-server#3042 · 2 commentaires ·
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
github/github-mcp-server#3032 · 1 réaction ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
github/github-mcp-server#2803 · 1 commentaire ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 76/100
github/github-mcp-server#2740 ·
Toutes les issues de github/github-mcp-server
Issues similaires
-
area/dev-productivity area/disaster-recovery area/ipcei kind/enhancement
Difficulté 2/5 1-3 heures Accessibilité débutants 70/100
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
-
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
-
kind/bug status/0-triage
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
-
🤔 refinement needed
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
equinor/radix-operator#1979 ·