バグ #308
未完了
Redmine Admin さんが約21時間前に追加.
約20時間前に更新.
説明
Claude.aiのWebUIから複数開発環境を統合管理するリモートMCP統合管理サーバーの実装計画を策定する。
実装対象システム¶
mcp.call2arm.com - リモートMCP Gateway Server
技術スタック¶
-
フレームワーク: TypeScript + Express.js + SSE transport
-
認証: OAuth 2.1 + PKCE (Claude Desktop Integration準拠)
-
インフラ: Docker Compose + Redis + Nginx SNI
-
管理対象: VPS-ROOT(85.131.243.51) + Windows端末(160.251.155.93)
実装フェーズ構成¶
Phase 1: MVP基盤構築 (Week 1-2)¶
- OAuth 2.1認証システム構築
- 基本SSH管理機能実装
- Claude.ai WebUI統合テスト
- 基本セキュリティ実装
Phase 2: 機能拡張 (Week 3-4)¶
- Docker Compose管理機能
- Redmine API統合強化
- ファイル操作機能
- 複数ホスト管理
Phase 3: プロダクション化 (Week 5-6)¶
- 監査ログシステム
- Rate Limiting実装
- セキュリティ強化
- 本番デプロイ・監視
参考実装¶
- Linear: mcp.linear.app/sse
- Atlassian: Jira & Confluence統合
- Azure APIM: OAuth 2.1実装例
予想工数¶
-
総工数: 112時間（約14営業日）
-
完成予定: 2025年6月末
制約・リスク¶
- Claude Code直接制御API不存在 → SSH Proxy方式で代替
- Claude DesktopアプリSSE未対応 → WebUI優先実装
- セキュリティ要件の厳格な実装必須
実装計画チケット化完了¶
📋 作成されたチケット¶
Phase 1: MVP基盤構築 (Week 1-2)¶
-
#309: OAuth 2.1認証システム実装
-
#310: SSH統合管理機能実装
-
#311: MCP Gateway基本実装
Phase 2: 機能拡張 (Week 3-4)¶
-
#312: Docker統合管理機能実装
-
#313: Redmine統合強化実装
Phase 3: プロダクション化 (Week 5-6)¶
-
#314: セキュリティ・監視システム実装
-
#315: 本番デプロイメント・稼働開始
🎯 実装計画概要¶
-
総チケット数: 7件 (親チケット含む)
-
予想工数: 112時間（約14営業日）
-
完成予定: 2025年6月末
-
最終目標: mcp.call2arm.com稼働開始
📈 次のアクション¶
Phase 1から順次実装開始
- OAuth 2.1認証基盤構築
- SSH管理機能実装
- Claude.ai WebUI統合テスト
全チケットが関連付けられ、実装準備完了しました。
Phase 1詳細チケット化完了 (4時間単位)¶
📋 Phase 1チケット分割結果¶
OAuth認証システム (16時間 → 4チケット)¶
-
#316: Discovery Endpoint実装 (4h)
-
#317: 認可エンドポイント・PKCE実装 (4h)
-
#318: ログイン画面・トークンエンドポイント (4h)
-
#319: 認証ミドルウェア・Redis統合 (4h)
SSH統合管理 (20時間 → 5チケット)¶
-
#320: 接続管理・node-ssh統合 (4h)
-
#321: コマンド実行機能実装 (4h)
-
#322: ファイル操作機能実装 (4h)
-
#323: ログ・セキュリティ機能実装 (4h)
-
#324: 統合テスト・デバッグ (4h)
MCP Gateway基本実装 (16時間 → 4チケット)¶
-
#325: SSE Transport・基盤実装 (4h)
-
#326: Tool実行ハンドラー・SSH統合 (4h)
-
#327: Docker・Nginx環境構築 (4h)
-
#328: Claude.ai統合テスト (4h)
📊 Phase 1詳細¶
-
総チケット数: 13件 (4時間単位)
-
総工数: 52時間
-
想定期間: Week 1-2 (約2週間)
🎯 実装順序¶
- OAuth基盤構築 (4チケット並行可能)
- SSH管理機能 (順次実装)
- MCP統合・テスト (最終段階)
4時間単位での詳細管理により作業精度が大幅に向上します。
全フェーズ詳細化完了 - 4時間単位チケット体系¶
📋 完成したチケット体系¶
Phase 1: MVP基盤構築 (52時間 / 13チケット)¶
OAuth認証 (16h / 4チケット)
- #316: Discovery Endpoint実装 (4h)
- #317: 認可エンドポイント・PKCE実装 (4h)
- #318: ログイン画面・トークンエンドポイント (4h)
- #319: 認証ミドルウェア・Redis統合 (4h)
SSH管理 (20h / 5チケット)
- #320: 接続管理・node-ssh統合 (4h)
- #321: コマンド実行機能実装 (4h)
- #322: ファイル操作機能実装 (4h)
- #323: ログ・セキュリティ機能実装 (4h)
- #324: 統合テスト・デバッグ (4h)
MCP Gateway (16h / 4チケット)
- #325: SSE Transport・基盤実装 (4h)
- #326: Tool実行ハンドラー・SSH統合 (4h)
- #327: Docker・Nginx環境構築 (4h)
- #328: Claude.ai統合テスト (4h)
Phase 2: 機能拡張 (36時間 / 9チケット)¶
Docker管理 (20h / 5チケット)
- #329: 管理基盤・コンテナ一覧 (4h)
- #330: Compose操作機能実装 (4h)
- #331: ログ・詳細情報機能 (4h)
- #332: ヘルスチェック・監視機能 (4h)
- #333: VPS-ROOT統合テスト (4h)
Redmine統合 (16h / 4チケット)
- #334: API基盤・チケット機能 (4h)
- #335: 更新・コメント機能 (4h)
- #336: 作業フロー・監査統合 (4h)
- #337: 統合テスト・既存API連携 (4h)
Phase 3: プロダクション化 (32時間 / 8チケット)¶
セキュリティ強化 (16h / 4チケット)
- #338: Rate Limiting・ポリシー (4h)
- #339: 監査ログ・異常検出 (4h)
- #340: 鍵管理・セッション強化 (4h)
- #341: ヘルスチェック・性能監視 (4h)
本番デプロイ (12h / 3チケット)
- #342: Docker・Nginx本番最適化 (4h)
- #343: 本番デプロイ・初期設定 (4h)
- #344: 本番統合テスト・稼働開始 (4h)
📊 総合統計¶
-
総チケット数: 30件 (4時間単位)
-
総工数: 120時間 (15営業日)
-
実装期間: 約6週間
-
完成予定: 2025年6月末
🎯 実装準備完了¶
詳細な4時間単位でのチケット分割により、以下が実現されます：
- 高精度な進捗管理
- 早期問題発見
- 品質向上
- リスク軽減
次のアクション: Phase 1 OAuth-1 (#316) から実装開始可能
Setup-1 完了報告¶
✅ TypeScript開発環境セットアップ完了¶
-
チケット: #345 完了・解決済みに更新
-
Git管理: 初期コミット
0220b39 完了
-
作業時間: 4時間（予定通り）
📂 構築した環境¶
/root/mcp-gateway/
├── src/server.ts (基本サーバー実装済み)
├── docker-compose.yml (Redis + Gateway設定)
├── nginx/mcp.call2arm.com.conf (SSL + Proxy設定)
├── Dockerfile (本番用)
└── 開発環境完全準備
🎯 実装準備完了¶
mcp.call2arm.com での開発環境が整い、Phase 1実装開始可能な状態です。
📋 次の実装推奨順序¶
-
#316: OAuth-1 Discovery Endpoint実装 (4h)
-
#317: OAuth-2 認可エンドポイント・PKCE実装 (4h)
-
#318: OAuth-3 ログイン画面・トークンエンドポイント (4h)
-
#319: OAuth-4 認証ミドルウェア・Redis統合 (4h)
次のアクション: Phase 1 OAuth基盤実装開始準備完了
他の形式にエクスポート: Atom
PDF