プロジェクト

全般

プロフィール

バグ #602

未完了

リモートMCP対応 - Claude Desktop連携基盤構築

Redmine Admin さんが約7時間前に追加. 約6時間前に更新.

ステータス:
新規
優先度:
高め
担当者:
-
開始日:
2025-06-19
期日:
進捗率:

0%

予定工数:

説明

目的

VPS-ROOT環境のMCPサーバをリモート対応させ、Claude Desktop連携を実現する

現状

  • ローカルMCPサーバ: Redmine統合、ファイルシステム、GitFLC、Docker管理等
  • リモート対応: 未実装
  • OAuth 2.1認証: 未実装

実施内容

  1. 現状MCP構成の確認・一覧化
  2. リモートMCP化対象の選定
  3. OAuth 2.1 + PKCE認証基盤構築
  4. Claude Desktop連携テスト

技術要件

  • OAuth 2.1 + PKCE (RFC7636)
  • Streamable HTTP Transport
  • /.well-known/oauth-authorization-server エンドポイント
  • 既存MCPサーバとの統合

Redmine Admin さんが約7時間前に更新

Phase 1: 現状確認完了

✅ 実施済み

  1. MCPサーバ構成調査: 現在利用可能な8個のMCPサーバを特定
  2. 優先度分析: リモート化優先度マトリックス作成
  3. 技術要件整理: OAuth 2.1 + PKCE, Streamable HTTP Transport

📋 確認結果

  • 高優先度: redmine-mcp, desktop-commander-wsl
  • 技術的複雑度: desktop-commander-wslが最高、redmine-mcpが中程度
  • 実装戦略: 段階的なリモート化(Phase 1-4)

🚀 Phase 2: OAuth認証基盤構築開始

次回作業:

  1. mcp.call2arm.com サブドメイン設定
  2. OAuth認証サーバー実装
  3. /.well-known エンドポイント構築

📄 成果物

  • MCPサーバ一覧表: アーティファクトとして格納済み
  • リモートMCP化戦略: 4段階の実装計画

Redmine Admin さんが約7時間前に更新

Phase 2: ブラウザベースMCPクライアント開発開始

🎯 目標

現在利用可能なMCPサーバ機能をすべてブラウザから利用可能にするWebアプリケーション開発

📋 開発対象

  1. Webベース統合MCPクライアント
  2. リモートMCP基盤との連携
  3. Claude Desktop代替UI

🔧 技術選定

  • React + TypeScript + TailwindCSS (VPS-ROOT標準)
  • FastMCP (Python) またはNode.js Express
  • OAuth 2.1 + JWT認証
  • WebSocket + HTTP API統合

📄 成果物作成

技術仕様書・処理一覧・機能一覧をアーティファクトとして作成中

Redmine Admin さんが約7時間前に更新

Phase 2: 技術仕様書作成完了 ✅

📋 完成成果物

  1. ブラウザベース統合MCPクライアント技術仕様書
    • 技術スタック: React+TS+FastAPI+OAuth2.1
    • 6カテゴリ機能設計: 認証・プロジェクト・ファイル・システム・ブラウザ・Git
    • 4フェーズ開発計画: 基盤→核心→拡張→最適化

🎯 主要設計決定

  • 認証: OAuth 2.1 + PKCE + JWT (リモートMCP標準)
  • UI/UX: LINEデザイン言語 + TailwindCSS (VPS-ROOT標準)
  • アーキテクチャ: マイクロサービス + Docker統合
  • セキュリティ: RBAC + 監査ログ + TLS1.3

🚀 Phase 3: 実装開始準備

  • OAuth認証基盤構築
  • mcp.call2arm.com サブドメイン設定
  • FastAPI + React プロジェクト初期化

📊 成功指標設定

  • 稼働率99.9%, エラー率<0.1%, 応答時間<500ms
  • VPS-ROOT利用者の80%+がWebクライアント利用
  • Claude Desktop機能の100%代替実現

Redmine Admin さんが約7時間前に更新

開発要件修正 - VPS-ROOT完全自己完結型

🎯 修正要件

  1. VPS-ROOT上での完全動作: 外部サービス依存なし
  2. 自己完結アーキテクチャ: 全コンポーネントをVPS内で運用
  3. チケット管理統合: 開発プロセス全体をRedmineで管理

🔄 技術仕様修正項目

  • 外部CDN・サービス排除
  • 完全ローカル認証システム
  • VPS-ROOT内Docker統合
  • チケット駆動開発(TDD)プロセス

📋 修正技術仕様書作成中

VPS-ROOT環境に最適化した技術仕様に全面改訂

Redmine Admin さんが約7時間前に更新

VPS-ROOT完全自己完結型技術仕様 完成 ✅

🎯 修正完了

  1. 外部依存100%排除: CDN・外部API・分析ツール一切使用禁止
  2. VPS統合アーキテクチャ: 既存proxy-network + Docker Compose統合
  3. チケット駆動開発: Redmine完全統合 + 自動デプロイ
  4. データ主権確保: SQLite + Redis (VPS内) + Session認証

🏗️ 技術構成

  • Frontend: React SPA + Nginx (既存SSL統合)
  • Backend: FastAPI + SQLite + VPS内Redis
  • Deploy: mcpweb.call2arm.com (新サブドメイン)
  • Auth: Session Cookie (OAuth複雑性排除)

🚀 開発計画

  • Total: 18日間 (4フェーズ)
  • Phase 1: Docker統合基盤 (2日)
  • Phase 2: MCP核心機能 (7日)
  • Phase 3: 拡張・認証 (5日)
  • Phase 4: 最適化・運用 (4日)

📋 Next Actions

  1. mcpweb.call2arm.com サブドメイン設定
  2. /root/mcp-web-client/ プロジェクト初期化
  3. Docker統合環境構築開始

VPS-ROOT完全内製でClaude Desktop代替Web環境の実現準備完了

Redmine Admin さんが約7時間前に更新

重要制約追加 - 既存MCPツール継続利用保証

🛡️ 安全実装方針

  1. 既存MCP環境完全保護: Claude Desktop接続MCPサーバに一切影響なし
  2. 並行運用: 既存MCP + 新WebクライアントのDual Operation
  3. 段階的移行: ユーザー選択による任意移行

🔧 実装戦略修正

  • Read-Only統合: 既存MCPサーバへの読み取り専用アクセス
  • 独立Webクライアント: 別系統での独立動作
  • 設定無変更: 既存claude_desktop_config.json完全保護

📋 安全実装仕様書作成中

既存環境影響ゼロの共存アーキテクチャに全面見直し

Redmine Admin さんが約7時間前に更新

既存MCP完全保護型並行運用仕様 完成 ✅

🛡️ 安全要件完全対応

  1. 既存環境完全保護: Claude Desktop設定・MCPサーバ・ログデータ無変更
  2. 並行運用システム: Read-Only統合 + 競合検出回避 + 独立ネットワーク
  3. 段階的移行: ユーザー選択自由 + A/Bテスト + ロールバック対応

🏗️ 保護アーキテクチャ

  • 保護層: 既存MCP → Read-Only統合 → 競合回避
  • 独立層: Web認証 + SQLite + 独立ネットワーク
  • 監視層: 安全性監視 + 競合検出 + 自動ロールバック

🚀 修正開発計画

  • Total: 25日間 (既存保護型4フェーズ)
  • Phase 1: 既存分析・保護設計 (4日)
  • Phase 2: 独立基本機能 (8日)
  • Phase 3: 高度統合・移行UI (7日)
  • Phase 4: 運用安定化・テスト (6日)

🎯 保護保証

  • 既存Claude Desktop MCP: 100%影響なし
  • 設定ファイル変更: 0%
  • 競合発生: 0% (自動回避)
  • ロールバック: 100%成功保証

既存MCPツールの完全保護を保証した並行運用システム設計完了

Redmine Admin さんが約6時間前に更新

📋 実装計画チケット作成完了 + 技術仕様書添付

✅ 作成済みチケット

  1. #603 - Phase 1: 既存MCP環境分析・保護設計 (4日間: 6/19-6/22)
  2. #604 - Phase 2: 独立基本機能実装 (8日間: 6/23-6/30)
  3. #605 - Phase 3: 高度統合・段階的移行UI (7日間: 7/1-7/7)
  4. #606 - Phase 4: 運用安定化・並行テスト (6日間: 7/8-7/13)

📄 技術仕様書 (添付ドキュメント)


VPS-ROOT並行運用型 統合MCPクライアント - 技術仕様書

🎯 プロジェクト概要

プロジェクト名

VPS-ROOT Parallel MCP Web Client

目的

既存Claude Desktop MCPツールとの完全共存を保ちながら、ブラウザベースでのMCP機能アクセスを提供。既存環境に一切影響を与えない並行運用システムを構築。

安全実装原則

  • 既存MCP環境完全保護: Claude Desktop接続に一切影響しない
  • 並行運用システム: 既存 + Web の Dual Operation
  • 設定変更禁止: claude_desktop_config.json等の既存設定変更なし
  • 段階的導入: ユーザー選択による任意利用・移行

🏗️ VPS-ROOT自己完結技術スタック

フロントエンド (完全ローカル)

  • React 18.3+ + TypeScript 5.0+ + Vite 5.0+
  • TailwindCSS 3.4+ (ローカルビルド、CDN使用禁止)
  • Zustand 4.5+ (Global State)
  • Headless UI 2.0+ (ローカルバンドル)
  • WebSocket (Native, VPS内部)

バックエンド (VPS-ROOT Docker統合)

  • FastAPI 0.110+ + FastMCP 2.0+ + Uvicorn 0.27+
  • SQLite 3.44+ (軽量データベース、ファイルベース)
  • Redis 7.2+ (既存VPS-ROOT Redis使用)
  • python-jose 3.3+ (JWT - ローカル生成)

インフラ・DevOps (VPS-ROOT統合)

  • Docker 25.0+ + Docker Compose 2.24+ (既存VPS-ROOT環境)
  • Nginx 1.25+ (既存proxy-network統合)
  • Let's Encrypt (既存ワイルドカード証明書使用)

🛠️ 並行運用アーキテクチャ

システム構成図 (既存保護型)

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│  Claude Desktop │    │   既存MCP群      │    │   VPS-ROOT      │
│                 │◄──►│  (完全保護)      │◄──►│   Environment   │
│ 既存設定保持    │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                │                        │
                                ▼                        ▼
┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Web Browser   │    │  MCP Web Client  │    │  Read-Only      │
│                 │◄──►│   (新規独立)     │◄──►│  Integration    │
│ 新UI体験        │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🔧 安全統合機能設計

1. 既存MCP保護機能 🛡️

  • Read-Only MCPブリッジ: 既存MCPサーバへの読み取り専用アクセス
  • 競合防止システム: 同時アクセス時の競合回避
  • 設定保護機能: claude_desktop_config.json等の完全保護

2. 独立Web機能 🌐

  • 独立Redmine統合: 既存redmine-mcpとは独立した直接API接続
  • 独立ファイルシステム: VPS-ROOT直接アクセス (既存MCPとは独立)

3. 段階的移行機能 🔄

  • ユーザー選択システム: desktop-only/web-only/dual-mode
  • A/Bテスト機能: ユーザー単位での機能比較

📊 実装スケジュール

Phase 1: 安全基盤 (4日間: 6/19-6/22)

  • 既存環境分析・保護設計
  • 独立Docker環境構築
  • Read-Only統合API実装

Phase 2: 基本機能 (8日間: 6/23-6/30)

  • 独立認証システム
  • Redmine独立統合
  • ファイルシステム安全統合

Phase 3: 高度統合 (7日間: 7/1-7/7)

  • 競合検出・回避システム
  • 段階的移行UI
  • A/Bテスト機能

Phase 4: 運用安定化 (6日間: 7/8-7/13)

  • 監視・安全性確認
  • ユーザー受入テスト
  • 並行運用開始

✅ 既存MCP保護 成功指標

保護指標

  • 既存機能稼働率: 100% (Claude Desktop MCP機能に影響なし)
  • 設定ファイル保護: 100% (claude_desktop_config.json変更なし)
  • 競合発生率: 0% (同時利用時の競合回避)
  • ロールバック成功率: 100% (問題時の即座復旧)

🛡️ 既存環境保護コミット

  1. ✅ claude_desktop_config.json 変更禁止
  2. ✅ 既存MCPサーバプロセス無変更
  3. ✅ Claude Desktop接続無影響
  4. ✅ 既存ログ・データ無変更
  5. ✅ ユーザー設定・プリファレンス保持

📋 Next Actions

  1. Phase 1開始: チケット#603実行
  2. 既存環境詳細分析: 影響範囲完全特定
  3. 保護システム設計: 競合回避機能詳細設計
  4. 開発環境準備: 独立Docker環境構築

総期間: 25日間で既存MCPツール完全保護型並行運用システム完成

Redmine Admin さんが約6時間前に更新

📋 現在利用可能MCPサーバ一覧 (添付ドキュメント)


VPS-ROOT環境 - 現在利用可能なMCPサーバ一覧

📋 Claude Desktop 接続中MCPサーバ(現在)

1. redmine-mcp 📝

  • 種別: プロジェクト管理 (Redmine統合)
  • 接続状況: ✅ 稼働中
  • 機能: Redmineチケット作成・更新・検索・削除、プロジェクト管理
  • API: Redmine REST API (call2arm.com)
  • リモート対応: 🎯 高優先度

2. desktop-commander-wsl 🖥️

  • 種別: システム管理 (WSL/Ubuntu 操作)
  • 接続状況: ✅ 稼働中
  • 機能: ファイルシステム操作、コマンド実行、プロセス管理
  • 接続先: VPS-ROOT (85.131.243.51)
  • リモート対応: 🎯 高優先度

3. filesystem 📁

  • 種別: ローカルファイルシステム
  • 接続状況: ✅ 稼働中
  • 対象: C:, E:, H:\ ドライブ
  • 機能: ファイル読み込み・書き込み、ディレクトリ管理
  • リモート対応: 🔶 中優先度

4. playwright 🌐

  • 種別: ブラウザ自動化
  • 接続状況: ✅ 稼働中
  • 機能: Web操作自動化、スクリーンショット取得
  • リモート対応: 🔶 中優先度

🔧 VPS-ROOT環境 利用可能MCPサーバ

5. git-local 📂

  • 配置: C:\Users\ito\git-mcp-local\
  • 種別: Git操作管理
  • 機能: ローカルGitリポジトリ操作
  • リモート対応: 🎯 高優先度

6. sqlite 🗄️

  • 種別: SQLiteデータベース管理
  • 機能: データベース操作・クエリ実行
  • リモート対応: 🔶 中優先度

7. web-search 🔍

  • 種別: Web検索機能
  • 機能: インターネット検索・情報取得
  • リモート対応: 🔶 中優先度

📊 リモートMCP化 優先度マトリックス

MCPサーバ 使用頻度 機能重要度 技術的複雑度 優先度
redmine-mcp 🔥 高 🔥 高 🟡 中 🎯 最高
desktop-commander-wsl 🔥 高 🔥 高 🔴 高 🎯
git-local 🟡 中 🟡 中 🟡 中 🔶
filesystem 🟡 中 🟡 中 🟢 低 🔶
playwright 🟡 中 🟡 中 🟡 中 🔶
sqlite 🟢 低 🟢 低 🟢 低 🔵
web-search 🟢 低 🟢 低 🟢 低 🔵

🛡️ 既存MCP保護対象

絶対保護対象

  • 設定ファイル: ~/.mcp/mcp-config.json
  • Claude Desktop設定: claude_desktop_config.json
  • 既存プロセス: 現在稼働中の全MCPサーバプロセス
  • ログファイル: ~/.config/claude/logs/mcp-*.log

保護方針

  • Read-Only統合: 既存MCPサーバへの読み取り専用アクセス
  • 競合回避: 同時アクセス時の自動制御
  • 設定無変更: 既存設定ファイルの完全保護
  • プロセス無干渉: 既存MCPプロセスへの一切の干渉禁止

他の形式にエクスポート: Atom PDF