devflow-mcp

AIアシスタントに高度なGitHub開発者ツール（PR分析、コードレビュー、チェンジログ生成、依存関係監査、コミット要約、リファクタリング提案）を提供する、プロダクションレディなModel Context Protocolサーバーです。

特徴

• 6つのMCPツール：開発ワークフロー全体をカバー

• ヒューリスティック分析：外部LLM呼び出しなし、高速かつ決定論的

• OSV.dev統合：実際の脆弱性データ（npmおよびPyPI）を利用

• LRUキャッシュ：TTL付きでGitHub API呼び出しを最小化

• トークンバケットレートリミッター：GitHubの制限内に収めるための制御

• Zero any：TypeScriptで厳密に型定義

• ≥80%のテストカバレッジ：MSWでモックされたHTTPテスト

要件

• Node.js 18以上

• repoスコープを持つGitHubパーソナルアクセストークン

インストール

npm install -g devflow-mcp

またはnpxで直接実行：

npx devflow-mcp

またはクローンしてビルド：

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

Claude Desktopの設定

claude_desktop_config.jsonに追加してください：

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

設定ファイルの場所：

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

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

ツール

analyze_pr

GitHubのプルリクエストを分析し、リスク、セキュリティ上の懸念、マージの準備状況を評価します。

パラメータ:

戻り値: risk_score (0-100), risk_level, findings[], change_summary, merge_recommendation

review_code

コードスニペットをレビューし、品質、セキュリティ上の問題、改善の機会を評価します。

パラメータ:

戻り値: overall_score (1-10), issues[] (重大度と修正案を含む), positive_observations[], refactor_priority

generate_changelog

コミット履歴から2つのGit参照間のチェンジログを生成します。

パラメータ:

戻り値: changelog 文字列, commit_count, カテゴリごとの stats, breaking_changes[]

audit_dependencies

OSV脆弱性データベースに対してプロジェクトの依存関係を監査します。

パラメータ:

戻り値: vulnerabilities[] (CVE ID、修正バージョン、修正コマンドを含む), audit_passed, 重大度ごとの stats, osv_query_timestamp

summarize_commits

ブランチの最近のコミットを要約し、人間が読める形式のダイジェストを作成します。

パラメータ:

戻り値: summary 文字列, categories (機能/修正/ドキュメント/リファクタリング/雑務/その他), authors[], commit_count

suggest_refactor

インパクトと労力の比率に基づいて、リファクタリングの機会を分析します。

パラメータ:

戻り値: suggestions[] (根拠と労力見積もりを含む), priority_order[], original_complexity_score

開発

# 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

プロジェクト構造

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

テスト戦略

• ユニットテスト: 各ツールハンドラーとライブラリをvi.mockでモック化

• 統合テスト: InMemoryTransportを介したMCPクライアントとサーバー間のフルラウンドトリップ、MSWでHTTPをインターセプト

• HTTPモック: MSW v2 (msw/node) — テスト中に実際のネットワーク呼び出しは行わない

• カバレッジ: ≥80%のブランチカバレッジを必須 (npm run test:coverage)

貢献

1. リポジトリをフォーク

2. フィーチャーブランチを作成

3. 新しい動作に対するテストを追加

4. npm run build && npm run test:coverage && npm run lint がすべてパスすることを確認

5. プルリクエストを作成

ライセンス

MIT

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers