Agentic MCP Server

MCP Server for Agentic Orchestration System - Claude Code Integration

Claude Code用のModel Context Protocol (MCP) Serverです。識学理論ベースのAI Agentシステムと統合し、GitHub Issue管理、コード生成、レビュー、PR作成などを自動化します。

🎯 概要

このMCP Serverは、Agentic Orchestration Systemの全AgentをClaude Codeから直接呼び出せるようにします。GitHub Actionsと連携して、Issue分析からコード生成、レビュー、PRまでの開発プロセスを完全自動化します。

主な機能

• IssueAgent: AI駆動Issue分析・Label自動付与

• CodeGenAgent: AI駆動コード生成・テスト自動生成

• ReviewAgent: 静的解析・セキュリティスキャン・品質判定

• PRAgent: PR自動作成・説明文AI生成

• CoordinatorAgent: タスク分解（DAG構築）・Agent選定

• KPI収集: 開発メトリクス自動収集・ダッシュボード生成

🚀 クイックスタート

1. インストール

2. ビルド

3. 環境変数設定

.envファイルを作成:

.envを編集してAPIキーを設定:

GitHub Token取得方法:

1. https://github.com/settings/tokens

2. "Generate new token (classic)"

3. 権限: repo, workflow, issues, pull_requests

4. Claude Code CLI設定

Claude Code CLIの設定ファイルに追加:

macOS/Linux: ~/.config/claude/claude_desktop_config.json

⚠️ 重要:

• パスは絶対パスを使用してください

• APIキーは直接記載（.envではなくClaude Code設定で管理）

• Claude Code CLIを再起動して設定を反映

5. 動作確認

Claude Code CLIセッション内で以下を確認:

🔧 利用可能なTools

1. agentic_codegen_execute

説明: CodeGenAgent実行 - AI駆動コード生成・テスト自動生成

パラメータ:

• issue_number (required): GitHub Issue番号

• title (required): タスクタイトル

• description (required): タスク詳細

• priority (optional): 優先度（P0-緊急/P1-高/P2-中/P3-低）

使用例:

2. agentic_review_execute

説明: ReviewAgent実行 - 静的解析・セキュリティスキャン・品質判定

パラメータ:

• issue_number (required): GitHub Issue番号

• target_files (optional): レビュー対象ファイルパス配列

使用例:

3. agentic_issue_analyze

説明: IssueAgent実行 - Issue内容AI分析・Label自動付与

パラメータ:

• issue_number (required): GitHub Issue番号

• title (required): Issue タイトル

• body (required): Issue 本文

使用例:

4. agentic_pr_create

説明: PRAgent実行 - PR自動作成・説明文AI生成

パラメータ:

• issue_number (required): GitHub Issue番号

• branch_name (optional): ブランチ名

使用例:

5. agentic_coordinator_decompose

説明: CoordinatorAgent実行 - タスク分解（DAG構築）・Agent選定

パラメータ:

• issue_number (required): GitHub Issue番号

• title (required): タスクタイトル

• description (required): タスク詳細

使用例:

6. agentic_kpi_collect

説明: KPI収集・ダッシュボード生成

パラメータ:

• period (optional): 集計期間（6h/24h/7d/30d）

使用例:

7. agentic_metrics_view

説明: 識学理論KPIダッシュボード表示

パラメータ: なし

使用例:

📊 識学理論対応

責任と権限の明確化

各Toolは対応するAgentの権限レベルで実行されます:

• CodeGenAgent: 🔵実行権限

• ReviewAgent: 🟡確認権限

• IssueAgent: 🔵実行権限

• PRAgent: 🔵実行権限

• CoordinatorAgent: 🔴決裁権限

結果重視

全Toolはquality_scoreを返し、客観的な評価を提供します。

エスカレーション

品質基準未達時は自動的にエスカレーションし、適切な担当者に通知します。

🧪 テスト

🔧 トラブルシューティング

Tools が表示されない

1. Claude Desktop設定を確認

2. パスが正しいか確認

3. Claude Desktop再起動

Agent実行エラー

1. GITHUB_TOKEN設定を確認

2. ANTHROPIC_API_KEY設定を確認

3. リポジトリパス確認

🤖 Agentic Orchestration MCP Server - Ready for Claude Code!