AWS Customer Playbook Advisor MCP

# AWS セキュリティプレイブックアドバイザー MCP - 要件定義書（MVP）

## 1. プロジェクト概要

### プロジェクト名
AWS Customer Playbook Advisor MCP

### リポジトリ
https://github.com/eisuke000111/aws-customer-playbook-advisor-mcp

### プロジェクト説明
AWSの公式セキュリティプレイブックフレームワーク（aws-customer-playbook-framework）を知識ベースとして活用し、セキュリティ担当者にリアルタイムで予防的セキュリティガイダンスを提供するMCPサーバー。

## 2. 目的・背景

### 目的
- AWSセキュリティのベストプラクティスを手軽にアクセス可能にする
- セキュリティインシデントの事前予防を支援する
- aws-customer-playbook-frameworkの実用的な活用を促進する
- セキュリティ知識の民主化を実現する

### 背景
- AWSセキュリティのベストプラクティスは散在している
- セキュリティ担当者は迅速な判断を求められる
- 公式プレイブックの存在は知られているが活用されていない
- MCPプロトコルによりAIアシスタントとの統合が可能になった

## 3. 機能要件（MVP）

### 3.1 主要機能

#### 予防的ガイダンス提供 (`get_prevention_guidance`)
- **入力**: AWSサービス名またはセキュリティ関連の質問
- **処理**: aws-customer-playbook-frameworkから関連情報を取得・解析
- **出力**: 具体的な予防策と実装手順

#### 対応シナリオ（最低限）
1. **S3セキュリティ強化**
   - 「S3のセキュリティを強化したい」
   - → S3公開アクセス防止プレイブックから予防策を抽出

2. **IAM設定見直し**
   - 「IAMの設定を見直したい」
   - → IAMクレデンシャル侵害プレイブックから予防策を抽出

## 4. 非機能要件

### 4.1 パフォーマンス
- GitHub API呼び出し：10秒以内に応答
- シンプルなエラーメッセージ提供

### 4.2 セキュリティ
- GitHub APIは公開リポジトリのみアクセス（認証不要）
- 入力値の基本的なバリデーション

## 5. 技術仕様

### 5.1 開発環境
- **言語**: TypeScript
- **ランタイム**: Node.js 18+
- **フレームワーク**: Model Context Protocol SDK

### 5.2 依存パッケージ（最小限）
```json
{
  "dependencies": {
    "@modelcontextprotocol/sdk": "^latest",
    "zod": "^latest"
  },
  "devDependencies": {
    "@types/node": "^latest",
    "typescript": "^latest"
  }
}
```

### 5.3 外部API
- **GitHub API**: aws-customer-playbook-frameworkリポジトリ（認証不要）

## 6. アーキテクチャ

### 6.1 システム構成
```
[Claude Desktop] ←→ [MCP Client] ←→ [AWS Security Advisor MCP] ←→ [GitHub API]
```

### 6.2 ディレクトリ構成（最小限）
```
aws-customer-playbook-advisor-mcp/
├── README.md
├── package.json
├── tsconfig.json
└── src/
    └── index.ts              # MCPサーバー全機能
```

## 7. 開発計画（MVP）

### 7.1 開発ステップ
1. **基盤構築**
   - [x] リポジトリ作成
   - [ ] プロジェクト初期化
   - [ ] 基本MCPサーバー実装

2. **機能実装**
   - [ ] GitHub APIからプレイブック取得
   - [ ] S3セキュリティガイダンス機能
   - [ ] IAMセキュリティガイダンス機能

3. **動作確認**
   - [ ] Claude Desktop連携テスト
   - [ ] 基本的なエラーハンドリング

### 7.2 成果物
- 動作するMCPサーバー（1つのファイル）
- README.md（使用方法）

## 8. 成功指標（MVP）

### 8.1 機能的指標
- S3セキュリティガイダンス機能の正常動作
- IAMセキュリティガイダンス機能の正常動作  
- Claude Desktopでの基本動作確認

### 8.2 品質指標
- 基本的なエラーハンドリング実装
- README.mdによる使用方法説明

---

**作成日**: 2025年6月29日  
**最終更新**: 2025年6月29日  
**バージョン**: 1.0 (MVP)  
**作成者**: プロジェクトチーム