README.md•6.38 kB
# Agentic MCP Server
**MCP Server for Agentic Orchestration System - Claude Code Integration**
Claude Code用のModel Context Protocol (MCP) Serverです。識学理論ベースのAI Agentシステムと統合し、GitHub Issue管理、コード生成、レビュー、PR作成などを自動化します。
[](https://opensource.org/licenses/MIT)
## 🎯 概要
この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. インストール
```bash
git clone https://github.com/ShunsukeHayashi/agentic-mcp-server.git
cd agentic-mcp-server
npm install
```
### 2. ビルド
```bash
npm run build
```
### 3. 環境変数設定
`.env`ファイルを作成:
```bash
cp .env.example .env
```
`.env`を編集してAPIキーを設定:
```env
GITHUB_TOKEN=your_github_token_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here
GITHUB_REPOSITORY=owner/repo
GITHUB_REPOSITORY_PATH=/path/to/your/repo
```
**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`
```json
{
"mcpServers": {
"agentic-orchestration": {
"command": "node",
"args": [
"/absolute/path/to/ai-course-content-generator-v.0.0.1/tools/agentic-mcp/dist/server.js"
],
"env": {
"GITHUB_TOKEN": "ghp_your_github_token_here",
"ANTHROPIC_API_KEY": "sk-ant-your_anthropic_api_key_here",
"GITHUB_REPOSITORY": "ShunsukeHayashi/ai-course-content-generator-v.0.0.1",
"GITHUB_REPOSITORY_PATH": "/absolute/path/to/ai-course-content-generator-v.0.0.1"
}
}
}
}
```
**⚠️ 重要**:
- パスは絶対パスを使用してください
- APIキーは直接記載（`.env`ではなくClaude Code設定で管理）
- Claude Code CLIを再起動して設定を反映
### 5. 動作確認
Claude Code CLIセッション内で以下を確認:
```
利用可能なMCPツール: agentic_codegen_execute, agentic_review_execute, ...
```
---
## 🔧 利用可能なTools
### 1. `agentic_codegen_execute`
**説明**: CodeGenAgent実行 - AI駆動コード生成・テスト自動生成
**パラメータ**:
- `issue_number` (required): GitHub Issue番号
- `title` (required): タスクタイトル
- `description` (required): タスク詳細
- `priority` (optional): 優先度（P0-緊急/P1-高/P2-中/P3-低）
**使用例**:
```
Claude Codeで以下のように使用:
Issue #123の実装をCodeGenAgentに実行させてください。
タイトル: ログイン機能実装
詳細: Firebase Authenticationでログイン画面を実装する
```
### 2. `agentic_review_execute`
**説明**: ReviewAgent実行 - 静的解析・セキュリティスキャン・品質判定
**パラメータ**:
- `issue_number` (required): GitHub Issue番号
- `target_files` (optional): レビュー対象ファイルパス配列
**使用例**:
```
現在の実装をReviewAgentで品質チェックしてください
```
### 3. `agentic_issue_analyze`
**説明**: IssueAgent実行 - Issue内容AI分析・Label自動付与
**パラメータ**:
- `issue_number` (required): GitHub Issue番号
- `title` (required): Issue タイトル
- `body` (required): Issue 本文
**使用例**:
```
Issue #456を分析して、識学理論Labelを推奨してください
```
### 4. `agentic_pr_create`
**説明**: PRAgent実行 - PR自動作成・説明文AI生成
**パラメータ**:
- `issue_number` (required): GitHub Issue番号
- `branch_name` (optional): ブランチ名
**使用例**:
```
Issue #789の実装が完了したので、PRAgentでPR作成してください
```
### 5. `agentic_coordinator_decompose`
**説明**: CoordinatorAgent実行 - タスク分解（DAG構築）・Agent選定
**パラメータ**:
- `issue_number` (required): GitHub Issue番号
- `title` (required): タスクタイトル
- `description` (required): タスク詳細
**使用例**:
```
大規模な機能実装タスクをCoordinatorAgentで分解してください
```
### 6. `agentic_kpi_collect`
**説明**: KPI収集・ダッシュボード生成
**パラメータ**:
- `period` (optional): 集計期間（6h/24h/7d/30d）
**使用例**:
```
過去24時間のKPIを収集してください
```
### 7. `agentic_metrics_view`
**説明**: 識学理論KPIダッシュボード表示
**パラメータ**: なし
**使用例**:
```
現在のKPIダッシュボードを表示してください
```
---
## 📊 識学理論対応
### 責任と権限の明確化
各Toolは対応するAgentの権限レベルで実行されます:
- CodeGenAgent: 🔵実行権限
- ReviewAgent: 🟡確認権限
- IssueAgent: 🔵実行権限
- PRAgent: 🔵実行権限
- CoordinatorAgent: 🔴決裁権限
### 結果重視
全Toolは`quality_score`を返し、客観的な評価を提供します。
### エスカレーション
品質基準未達時は自動的にエスカレーションし、適切な担当者に通知します。
---
## 🧪 テスト
```bash
# MCP Server起動テスト
npm run dev
# 別ターミナルで
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | node dist/server.js
```
---
## 🔧 トラブルシューティング
### 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!**