devflow-mcp

Ein produktionsreifer Model Context Protocol-Server, der KI-Assistenten tiefgreifende GitHub-Entwicklertools an die Hand gibt – PR-Analyse, Code-Review, Changelog-Generierung, Abhängigkeitsprüfung, Commit-Zusammenfassungen und Refactoring-Vorschläge.

Funktionen

• 6 MCP-Tools, die den gesamten Entwickler-Workflow abdecken

• Heuristische Analyse – keine externen LLM-Aufrufe, schnell und deterministisch

• OSV.dev-Integration für echte Schwachstellendaten (npm und PyPI)

• LRU-Cache mit TTL zur Minimierung von GitHub-API-Aufrufen

• Token-Bucket-Rate-Limiter, um innerhalb der GitHub-Limits zu bleiben

• Kein any – durchgehend striktes TypeScript

• ≥80% Testabdeckung mit MSW-gemocktem HTTP

Anforderungen

• Node.js 18+

• Ein GitHub Personal Access Token mit repo-Berechtigung

Installation

npm install -g devflow-mcp

Oder direkt mit npx ausführen:

npx devflow-mcp

Oder klonen und bauen:

git clone https://github.com/yourorg/devflow-mcp
cd devflow-mcp
npm install
npm run build

Claude Desktop-Konfiguration

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
 "mcpServers": {
 "devflow": {
 "command": "npx",
 "args": ["devflow-mcp"],
 "env": {
 "GITHUB_TOKEN": "ghp_your_token_here"
 }
 }
 }
}

Speicherorte der Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Tools

analyze_pr

Analysiert einen GitHub Pull Request auf Risiken, Sicherheitsbefunde und Merge-Bereitschaft.

Parameter:

Rückgabewerte: risk_score (0-100), risk_level, findings[], change_summary, merge_recommendation

review_code

Überprüft einen Code-Schnipsel auf Qualität, Sicherheitsprobleme und Verbesserungsmöglichkeiten.

Parameter:

Rückgabewerte: overall_score (1-10), issues[] mit Schweregrad + Korrekturvorschlägen, positive_observations[], refactor_priority

generate_changelog

Generiert ein Changelog zwischen zwei Git-Refs aus der Commit-Historie.

Parameter:

Rückgabewerte: changelog string, commit_count, stats pro Kategorie, breaking_changes[]

audit_dependencies

Prüft Projektabhängigkeiten gegen die OSV-Schwachstellendatenbank.

Parameter:

Rückgabewerte: vulnerabilities[] mit CVE-IDs, Fix-Versionen und Fix-Befehlen; audit_passed, stats pro Schweregrad, osv_query_timestamp

summarize_commits

Fasst aktuelle Commits auf einem Branch zu einer menschenlesbaren Zusammenfassung zusammen.

Parameter:

Rückgabewerte: summary string, categories (features/fixes/docs/refactors/chores/other), authors[], commit_count

suggest_refactor

Analysiert Code auf Refactoring-Möglichkeiten, sortiert nach dem Verhältnis von Aufwand zu Nutzen.

Parameter:

Rückgabewerte: suggestions[] mit Begründung und Aufwandsschätzungen, priority_order[], original_complexity_score

Entwicklung

# Install dependencies
npm install

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Type-check and build
npm run build

# Lint
npm run lint

# Format
npm run format

# Start the server (after build)
npm start

Projektstruktur

src/
 index.ts # Entry point
 server.ts # MCP server registration
 tools/ # Tool handlers (one per tool)
 github/ # GitHub API clients
 lib/ # Shared utilities
 cache.ts # LRU cache with TTL
 rate-limiter.ts # Token-bucket rate limiter
 commit-parser.ts # Conventional commit parser
 diff-parser.ts # Git diff parser
 risk-scorer.ts # PR risk scoring heuristics
 errors.ts # Typed MCP errors
 providers/
 osv.ts # OSV.dev vulnerability API
tests/
 integration/ # Full MCP server tests via InMemoryTransport
 tools/ # Unit tests per tool handler
 lib/ # Unit tests for utilities

Teststrategie

• Unit-Tests: jeder Tool-Handler und jede Bibliothek mit vi.mock gemockt

• Integrationstests: vollständiger MCP-Client↔Server-Roundtrip über InMemoryTransport, HTTP abgefangen mit MSW

• HTTP-Mocking: MSW v2 (msw/node) – keine echten Netzwerkaufrufe in Tests

• Abdeckung: ≥80% Zweigabdeckung erforderlich (npm run test:coverage)

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch

3. Fügen Sie Tests für neues Verhalten hinzu

4. Stellen Sie sicher, dass npm run build && npm run test:coverage && npm run lint erfolgreich durchlaufen

5. Öffnen Sie einen Pull Request

Lizenz

MIT

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers