gha-intel-mcp
Ein MCP-Server für die Analyse der GitHub Actions Workflow-Zeiten, Konfigurationsaudit und Einblicke in die Abrechnung.
Werkzeuge
Werkzeug | Beschreibung |
| Berechnet Durchschnitts-, Min-, Max- und p95-Dauerstatistiken für kürzliche Workflow-Läufe. |
| Bewertet Workflow-YAML hinsichtlich Caching, Parallelität, Nebenläufigkeit, Artefakte, Checkout-Tiefe, Timeouts, Runner-Pinning, Docker-Caching und Triggern. |
| Liefert Abrechnungsminuten und geschätzte Kosten nach Runner-Typ sowie die Cache-Nutzung pro Repository. |
Related MCP server: copilot-usage-mcp
Anforderungen
Node.js >= 18 (nutzt natives
fetch)Ein persönlicher GitHub-Zugriffstoken mit den Bereichen
repoundread:org
Einrichtung
Drei Transportmodi sind verfügbar. Wählen Sie den, der zu Ihrer Bereitstellung passt:
Option A: stdio (lokal, empfohlen für Desktop-Clients)
Der Server läuft als Unterprozess des MCP-Clients über stdin/stdout. Kein Netzwerkport erforderlich.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
%APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Claude Code
claude mcp add gha-intel -e GITHUB_TOKEN=ghp_your_token -- npx -y @barissozudogru/gha-intel-mcpCursor
~/.cursor/mcp.json
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}VS Code + Copilot
.vscode/mcp.json (Arbeitsbereich) oder Benutzereinstellungen
{
"servers": {
"gha-intel": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Cline
Öffnen Sie die Cline-Einstellungen, navigieren Sie zu MCP-Servern und fügen Sie hinzu:
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Continue.dev
~/.continue/config.yaml
mcpServers:
- name: gha-intel
command: npx
args:
- -y
- "@barissozudogru/gha-intel-mcp"
env:
GITHUB_TOKEN: ghp_your_tokenZed
~/.config/zed/settings.json
{
"context_servers": {
"gha-intel": {
"command": {
"path": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}
}JetBrains (IntelliJ, PyCharm, WebStorm, etc.)
Gehen Sie zu Einstellungen > Tools > KI-Assistent > MCP und fügen Sie hinzu:
{
"mcpServers": {
"gha-intel": {
"command": "npx",
"args": ["-y", "@barissozudogru/gha-intel-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your_token"
}
}
}
}Option B: HTTP (Remote- oder Cloud-Clients)
Starten Sie den Server im HTTP-Modus und weisen Sie Clients an den Endpunkt:
GITHUB_TOKEN=ghp_your_token npx @barissozudogru/gha-intel-mcp --http
# Server listens on http://0.0.0.0:3000/mcp
# Health check: http://localhost:3000/healthOder setzen Sie es über eine Umgebungsvariable anstelle des Flags:
TRANSPORT=http PORT=3000 GITHUB_TOKEN=ghp_your_token npx @barissozudogru/gha-intel-mcpCursor (HTTP)
~/.cursor/mcp.json
{
"mcpServers": {
"gha-intel": {
"url": "http://localhost:3000/mcp"
}
}
}VS Code + Copilot (HTTP)
.vscode/mcp.json
{
"servers": {
"gha-intel": {
"type": "http",
"url": "http://localhost:3000/mcp"
}
}
}Windsurf (HTTP)
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gha-intel": {
"serverUrl": "http://localhost:3000/mcp"
}
}
}Continue.dev (HTTP)
~/.continue/config.yaml
mcpServers:
- name: gha-intel
url: http://localhost:3000/mcpOption C: Docker
docker build -t gha-intel-mcp .
docker run -p 3000:3000 -e GITHUB_TOKEN=ghp_your_token gha-intel-mcpDer Container startet standardmäßig im HTTP-Modus. Richten Sie Ihren Client auf http://localhost:3000/mcp.
Werkzeugreferenz
list_workflow_performance
Rufen Sie echte Laufzeitdaten ab und berechnen Sie Statistiken auf Job-Ebene.
Parameter | Typ | Erforderlich | Beschreibung |
| string | ja | GitHub-Besitzer (Benutzer oder Organisation) |
| string | ja | Name des Repositorys |
| string | ja | Workflow-Dateiname (z. B. |
| number | nein | Anzahl der letzten Läufe zur Analyse (Standard: 10, max: 100) |
Ausgabe: Zeitstatistiken pro Job und Schritt (Durchschnitt, Min, Max, p95), Gesamtlaufzeit und eine Liste der letzten Lauf-Ergebnisse.
analyze_workflow_config
Analysieren und prüfen Sie eine Workflow-YAML auf Optimierungsmöglichkeiten.
Parameter | Typ | Erforderlich | Beschreibung |
| string | ja | Vollständiger YAML-Inhalt der Workflow-Datei |
Ausgabe: Ergebnisse nach Schweregrad gruppiert (kritisch / Warnung / Info / gut) über neun Kategorien, jeweils mit einer konkreten Empfehlung.
Analysierte Kategorien: Abhängigkeits-Caching, Matrix-Strategie und Fail-Fast, Nebenläufigkeitsgruppen und Abbrechen in Bearbeitung, Artefakt-Uploads, Git-Checkout-Tiefe, Job-Timeout-Minuten, Runner-Versions-Pinning, Docker-Layer-Caching und Trigger-Pfadfilter.
get_billing_usage
Rufen Sie Abrechnungs- und Cache-Verbrauchsdaten ab.
Parameter | Typ | Erforderlich | Beschreibung |
| string | ja | GitHub-Benutzername oder Organisation |
| string | nein | Repository-Name für repo-spezifische Cache- und Laufstatistiken |
Ausgabe: Gesamtminuten, Planauslastung, geschätzte Kosten aufgeschlüsselt nach Runner-Typ (Ubuntu / macOS / Windows / große Runner) sowie Cache-Größe und Auslastungsprozentsatz pro Repository.
Umgebungsvariablen
Variable | Erforderlich | Beschreibung |
| ja | Persönlicher GitHub-Zugriffstoken. Erfordert den Bereich |
| nein | Auf |
| nein | HTTP-Port im HTTP-Modus (Standard: |
Lizenz
MIT
Available Tools
3 toolsanalyze_workflow_configAnalyze Workflow ConfigA
Parse a GitHub Actions workflow YAML (provided as a string) and identify optimization opportunities: missing caches, matrix strategy, concurrency controls, slow dependency installs, artifact handling, and more.
Inputs: workflow_content (required).
get_billing_usageGet Billing UsageA
Retrieve GitHub Actions billing and cache usage statistics for an owner (user or org), optionally scoped to a specific repository.
Inputs: owner (required), repo.
list_workflow_performanceList Workflow PerformanceA
Fetch the last N workflow runs and compute job-level timing statistics (avg, min, max, p95) across those runs. Useful for identifying slow jobs and trends.
Inputs: repo (required), owner (required), workflow_id (required), count.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool addresses a clearly distinct aspect: runtime performance metrics, static configuration analysis, and billing/cost usage. There is no overlap in purpose or data source, so an agent can reliably select the right tool.
All tool names follow a consistent verb_noun pattern: list_workflow_performance, analyze_workflow_config, get_billing_usage. The verbs (list, analyze, get) and nouns clearly indicate the action and subject, maintaining uniformity across the set.
With only 3 tools, the server is minimally scoped but each tool serves a distinct, valuable function within the GitHub Actions intel domain. The count is within the typical 3-15 range, though one could argue it's slightly on the lower end for comprehensive coverage.
The tools cover performance metrics, config analysis, and billing, but there's a notable gap: no tool to fetch the workflow YAML directly, forcing an external step for configuration analysis. Additionally, lifecycle operations like listing workflows or runs are missing, though performance stats partially address that.
Maintenance
Related MCP Connectors
Create, deploy, and operate MCP servers directly from your GitHub repositories.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server for Appcircle mobile CI/CD platform.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for GitHub Actions — view workflow runs, read logs, re-run failed jobs, and manage CI/CD.955 npm5MIT
- AlicenseAqualityDmaintenanceAn MCP server that retrieves GitHub Copilot usage metrics and seat assignment data across Enterprise, Organization, and Team levels. It allows users to monitor code completions, chat activity, and active user counts through integrated tools.5MIT
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server that provides AI assistants with comprehensive GitHub developer tooling including PR analysis, code review, changelog generation, dependency auditing, commit summarization, and refactoring suggestions.MIT
- AlicenseAqualityDmaintenanceAn MCP server that enables AI agents to perform comprehensive GitHub security audits across org settings, repositories, Actions workflows, secrets, supply chain, and access control using 39 tools and 45 checks.39110 npm15MIT