GitHub Intelligence MCP sunucusu
Commit 21 Eki 2026GitHub depolararını, issue'ları, pull request'leri ve commit'leri incelemek ve analiz etmek için AI istemcilerine yapılandırılmış, doğrulanmış JSON verileri sağlar.
Ayrıca bilinen adı Dayyan-Saeed/Github-Intelligence-Mcp
- Yıldızlar
- 2
- Araçlar
- 7
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 21 Eki 2026
- Lisans
- MIT
GitHub Intelligence MCP nedir?
GitHub Intelligence bir MCP sunucusudur. GitHub depolararını, issue'ları, pull request'leri ve commit'leri incelemek ve analiz etmek için AI istemcilerine yapılandırılmış, doğrulanmış JSON verileri sağlar. 7 araç sunar; örneğin get_repository, search_repositories, get_issues.
Özet, projenin README dosyasından oluşturuldu
GitHub Intelligence MCP sunucusu hakkında
Bu sunucu; Claude, Cursor veya OpenCode gibi AI istemcileri üzerinden GitHub deposu sağlığını ve metriklerini analiz etmenize olanak tanır. Geliştiricilere ve AI agent'lara, depo istatistiklerini tahmin etmesi için bir LLM'e güvenmek yerine deterministik ve doğrulanmış JSON verileri sunar. Verileri çekme ve yapılandırma gibi ağır işleri üstlenerek, modelin hata payı yüksek hesaplamalar yerine akıl yürütmeye odaklanmasını sağlar.
Kullanıcılar bu sunucuyu Python 3.12 ve uv kullanarak stdio üzerinden yerel olarak çalıştırabilirler. Bağlanmak için GITHUB_TOKEN ortam değişkeni aracılığıyla bir GitHub Personal Access Token sağlamanız gerekir. Sunucu; get_repository, search_repositories, get_issues, get_pull_requests, get_recent_commits, get_contributors ve get_releases gibi salt okunur araçlar sunar. Tüm listeleme işlemleri, kararlılığı sağlamak amacıyla 1 ile 100 öğe arasında sınırlandırılmıştır.
Bu araç; meta veriler, katkıda bulunanlar ve sürüm geçmişi hakkında güvenilir gerçeklere ihtiyaç duyanlar için tasarlanmıştır. Kararlı bir çıktı sözleşmesi sağlamak için Pydantic modellerini kullanır; bu da döndürülen verilerin her zaman yapılandırılmış ve öngörülebilir olduğu anlamına gelir. Ayrıca, GitHub API sorunlarını net ve kullanıcı dostu mesajlara dönüştürmek için yerleşik hata yönetimi içerir.
Neler yapabilirsiniz
- 1Depo aktivitesini karşılaştırınBir AI'dan iki farklı depo arasındaki yıldız sayılarını, issue sağlığını ve son aktiviteleri karşılaştırmasını isteyin.
- 2En önemli katkıda bulunanları belirleyinBelirli bir projeye katkıda bulunan en aktif geliştiricilerin listesini talep edin.
- 3Son yazılım sürümlerini takip edinBir depoda son zamanlarda nelerin birleştirildiğini (merged) veya yayınlandığını öğrenin.
- 4Depo issue'larını denetleyinBir depo içindeki issue'ları belirli etiketlere veya durumlara göre filtreleyerek arayın ve analiz edin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
GitHub Intelligence MCP araçları 7
README dosyasından algılandıget_repositorysearch_repositoriesget_issuesget_pull_requestsget_recent_commitsget_contributorsget_releases
| get_repository | — | |
| search_repositories | — | |
| get_issues | — | |
| get_pull_requests | — | |
| get_recent_commits | — | |
| get_contributors | — | |
| get_releases | — |
Yapılandırma
GITHUB_TOKEN
| Ad | Açıklama | Sunucu |
|---|---|---|
| GITHUB_TOKEN | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirdayyan-saeed/github-intelligence-mcp is public and reachablegithub.com/dayyan-saeed/github-intelligence-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-21github.com/dayyan-saeed/github-intelligence-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
GitHub Intelligence MCP
Live Dashboard: https://github-intelligence-mcp-ashy.vercel.app/
An intelligent, structured MCP (Model Context Protocol) server for investigating and analyzing GitHub repositories.
MCP-compatible AI clients (OpenCode, Claude, Cursor, etc.) connect to this server and gain read-only tools that return deterministic, validated, structured JSON about any GitHub repository — metadata, issues, pull requests, commits, contributors, releases, and search.
Why it exists
AI agents answering questions like "analyze facebook/react" or "find stale issues" need reliable facts. Computing repository metrics with an LLM is slow, expensive, and error-prone. This server does the deterministic work in code — fetching, validating, bounding, and structuring GitHub data — so the LLM can focus on what it is good at: reasoning and explanation.
Architecture
┌───────────────────────────── MCP client (LLM) ─────────────────────────────┐
│ asks questions, reasons over structured results │
└───────────────────────────────┬───────────────────────────────────────────┘
│ MCP protocol (stdio JSON-RPC)
┌───────────────────────────────▼───────────────────────────────────────────┐
│ server.py MCPServer assembly + tool registration │
├───────────────────────────────────────────────────────────────────────────┤
│ tools/* tool boundary: validation, logging, clean errors │
├───────────────────────────────────────────────────────────────────────────┤
│ github/* async GitHub REST client (httpx), payload mapping │
├───────────────────────────────────────────────────────────────────────────┤
│ models/* stable Pydantic response models (output contract) │
└───────────────────────────────┬───────────────────────────────────────────┘
│ HTTPS + Bearer token
▼ GitHub REST API v3
Key layers are strictly separated: the github package knows nothing about
MCP; the tools package contains no HTTP logic; the models package defines
a stable output contract decoupled from raw API payloads. See
docs/architecture.md for the reasoning behind every
decision.
Available tools (Phase 1 MVP)
| Tool | Description |
|---|---|
get_repository |
Structured metadata for one repository (stars, forks, license, timestamps, …) |
search_repositories |
Search repos; optional sort (stars, forks, help-wanted-issues, updated), order, bounded limit |
get_issues |
Issues filtered by state/labels/sort — pull requests automatically excluded |
get_pull_requests |
PRs with created/updated/closed/merged timestamps and draft flag |
get_recent_commits |
Commits from the last N days (1–365) with author/committer info |
get_contributors |
Top contributors by contribution count |
get_releases |
Recent releases with tag, author, draft/prerelease flags |
All list operations accept a limit clamped to 1–100, enforced twice:
once by the generated input schema, once inside the service layer.
Example interaction
An MCP client calling the server over stdio:
{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": {"name": "get_repository", "arguments": {"owner": "facebook", "repo": "react"}}}
returns structured content:
{
"name": "react",
"full_name": "facebook/react",
"stars": 238000,
"open_issues": 612,
"license": "MIT",
"default_branch": "main",
"created_at": "2013-05-24T16:15:54Z"
}
Natural-language prompts the tools support:
- "Compare stars, issue health, and recent activity of X and Y."
- "Who are the most active contributors of this repository?"
- "What was merged or released here recently?"
Installation
Requirements: Python 3.12+ and uv.
git clone <repository-url>
cd github-intelligence-mcp
uv sync
cp .env.example .env # then set GITHUB_TOKEN in .env
Create a GitHub token at https://github.com/settings/tokens — a fine-grained token with read-only access is sufficient.
Running locally
uv run github-intelligence-mcp # stdio transport (default)
Connecting to an MCP client
Example OpenCode configuration (opencode.json):
{
"mcp": {
"github-intelligence": {
"type": "local",
"command": ["uv", "run", "--directory", "/path/to/github-intelligence-mcp", "github-intelligence-mcp"],
"environment": { "GITHUB_TOKEN": "your-token" }
}
}
}
Claude Desktop (claude_desktop_config.json) uses the equivalent
mcpServers block with command/args.
Configuration
| Variable | Required | Default | Purpose |
|---|---|---|---|
GITHUB_TOKEN |
yes | — | GitHub PAT used for all requests |
GITHUB_API_URL |
no | https://api.github.com |
API root (useful for GitHub Enterprise) |
LOG_LEVEL |
no | INFO |
DEBUG…CRITICAL; logs go to stderr |
REQUEST_TIMEOUT_SECONDS |
no | 30 |
Per-request HTTP timeout |
CACHE_ENABLED |
no | false |
Reserved for Phase 4 response caching |
CACHE_TTL_SECONDS |
no | 300 |
Reserved for Phase 4 response caching |
Secrets are never hardcoded and never logged: the token lives in a
SecretStr and is only materialized inside the Authorization header.
Error handling
Domain exceptions map to clean, user-safe messages — never stack traces, never credentials:
| Situation | Client sees |
|---|---|
| Unknown/private repo | Repository 'owner/repo' was not found or is inaccessible. |
| Bad token | GitHub rejected the configured credentials. Check GITHUB_TOKEN. |
| Rate limit exhausted | GitHub API rate limit exceeded. Please retry after the provided reset time. Reset at: … |
| Missing permission | The configured token does not have permission to access this resource. |
| Invalid input | Field-specific validation message |
Transient failures (5xx, network errors) retry up to 3 times with capped exponential backoff. Client errors are never retried.
Repository health algorithm (Phase 2 roadmap)
Phase 2 adds deterministic scoring — no LLM involved — using explainable, documented weights:
| Component | Weight | Signals |
|---|---|---|
| Activity | 25% | commits 30/90 days, active contributors, recent PRs/releases |
| Issue health | 20% | stale-issue ratio, closure activity, average age (stale = open & untouched ≥ 90 days) |
| PR health | 20% | open/stale PR counts, merge cadence (stale = open ≥ 30 days) |
| Contributor health | 15% | active contributor count, concentration / bus-factor risk |
| Release activity | 10% | release intervals over 30/90-day windows |
| Documentation | 10% | README/docs/license presence signals |
Each component yields a 0–100 score with published formulas so results are reproducible.
Security model
- Read-only V1: no write operations exist to misuse; attack surface stays minimal.
- Input allow-lists prevent path traversal via
owner/repo. - Pagination and retries are bounded by construction.
- Logs contain tool names, repos, durations, statuses — never tokens or headers.
- Unanticipated exceptions are masked by the SDK; clients only see curated messages.
Testing
uv run pytest # 100% offline — respx mocks every HTTP call
Unit tests cover config, validation, models, client behavior (auth headers,
error mapping, retries, rate limits, pagination), and service filtering.
Integration tests drive the real MCPServer instance end-to-end: schema
generation, dispatch, structured output, and error translation.
Docker
docker build -t github-intelligence-mcp .
docker run --rm -i -e GITHUB_TOKEN=ghp_xxx github-intelligence-mcp
Multi-stage build on python:3.12-slim, runs as non-root, installs from the
committed uv.lock, and receives secrets only at runtime.
Development
See docs/development.md. Quality gates:
uv run ruff check .
uv run ruff format --check .
uv run mypy .
uv run pytest
CI runs all four on every push and pull request.
Roadmap
- Phase 2 — deterministic health analysis, maintenance-risk detection, repository comparison
- Phase 3 — MCP resources (
github://repo/{owner}/{repo}/…) and guided prompts - Phase 4 — SQLite response cache with per-endpoint TTLs, advanced rate-limit handling, GraphQL
- Phase 5 — LangGraph autonomous investigation agent
- Phase 6 — Next.js dashboard
License
GitHub Intelligence MCP soruları
GitHub Intelligence MCP hangi araçları sunar?
7 araç sunar; bunlar arasında get_repository, search_repositories, get_issues, get_pull_requests, get_recent_commits yer alır.
GitHub'dan ne tür veriler çekebilirim?
Sunucu; yapılandırılmış meta verileri, issue'ları, pull request'leri, commit'leri, katkıda bulunanları (contributors) ve sürümleri (releases) sağlar.
Bu sunucuyu kullanmak için bir GitHub token'ına ihtiyacım var mı?
Evet, bir GitHub Personal Access Token (PAT) gereklidir. Salt okunur (read-only) erişime sahip fine-grained bir token yeterlidir.
Bu sunucu depolarımda değişiklik yapabilir mi?
Hayır, mevcut sürüm salt okunur moddadır ve herhangi bir yazma işlemi içermez.
Bir depo bulunamadığında hatalar nasıl yönetiliyor?
Sunucu, bir stack trace yerine temiz ve kullanıcı dostu bir mesaj döndürür.