操作
バグ #345
未完了Setup-1: TypeScript開発環境セットアップ (4h)
ステータス:
解決
優先度:
高め
担当者:
-
開始日:
2025-06-07
期日:
進捗率:
0%
予定工数:
説明
リモートMCP統合管理サーバー開発用のTypeScript環境をセットアップする。
セットアップ内容¶
1. プロジェクト基盤構築¶
# VPS-ROOT環境での作業
cd /root
mkdir -p mcp-gateway && cd mcp-gateway
# Git初期化
git init
git remote add origin <repository-url>
# TypeScriptプロジェクト初期化
npm init -y
npm install typescript @types/node ts-node nodemon --save-dev
npx tsc --init
2. 必要ライブラリインストール¶
# MCP関連
npm install @modelcontextprotocol/sdk
# サーバー・認証関連
npm install express cors helmet jsonwebtoken
npm install @types/express @types/cors @types/jsonwebtoken --save-dev
# SSH・Redis関連
npm install node-ssh ioredis
npm install @types/node-ssh @types/ioredis --save-dev
# セキュリティ・ユーティリティ
npm install express-rate-limit rate-limit-redis axios joi winston
npm install @types/express-rate-limit --save-dev
3. プロジェクト構造作成¶
/root/mcp-gateway/
├── src/
│ ├── server.ts # メインサーバー
│ ├── auth/
│ │ └── oauth.ts # OAuth実装
│ ├── managers/
│ │ ├── ssh-manager.ts # SSH管理
│ │ ├── docker-manager.ts # Docker管理
│ │ └── redmine-manager.ts # Redmine管理
│ ├── security/
│ │ ├── audit.ts # 監査ログ
│ │ └── rate-limiter.ts # Rate Limiting
│ └── types/
│ └── index.ts # 型定義
├── nginx/
│ └── mcp.call2arm.com.conf # Nginx設定
├── ssh-keys/ # SSH鍵格納
├── docker-compose.yml # 開発用
├── docker-compose.prod.yml # 本番用
├── Dockerfile
├── .env.example
├── .gitignore
└── README.md
4. 開発用設定ファイル¶
- tsconfig.json: TypeScript設定
- package.json: scripts設定
- .env.example: 環境変数テンプレート
- .gitignore: Git除外設定
- docker-compose.yml: 開発環境用
5. 開発サーバー起動確認¶
# 開発サーバー起動テスト
npm run dev
# 基本エンドポイント確認
curl http://localhost:3000/health
成果物¶
- TypeScript開発環境完成
- プロジェクト構造確立
- 開発サーバー起動確認
- Git管理体制確立
作業時間: 4時間¶
前提条件: VPS-ROOT環境アクセス¶
Redmine Admin さんが約17時間前に更新
作業開始承認 - mcp.call2arm.com構築¶
🎯 構築対象¶
- サブドメイン: mcp.call2arm.com
- 環境: VPS-ROOT (85.131.243.51)
- SSL: 既存ワイルドカード証明書活用
- ネットワーク: proxy-network, unified-network
📂 作業ディレクトリ¶
/root/mcp-gateway/ # メインプロジェクト
🔧 技術スタック確定¶
- Runtime: Node.js + TypeScript
- Framework: Express.js + SSE transport
- DB: Redis (セッション・ログ)
- Auth: OAuth 2.1 + PKCE
- Container: Docker Compose
- Proxy: Nginx SNI
📋 作業手順¶
- プロジェクト基盤作成
- TypeScript環境構築
- 依存関係インストール
- プロジェクト構造確立
- 開発サーバー起動確認
作業を開始します。
Redmine Admin さんが約17時間前に更新
Setup-1 作業完了 ✅¶
🎯 完了した作業内容¶
1. プロジェクト基盤構築¶
-
ディレクトリ:
/root/mcp-gateway/作成完了 - Node.js: v18.19.1 確認済み
- npm: 9.2.0 利用可能
2. TypeScript環境構築¶
- package.json: プロジェクト初期化完了
- TypeScript: コンパイラ・型定義インストール完了
- tsconfig.json: 適切な設定で生成・カスタマイズ完了
3. 依存関係インストール完了¶
# MCP SDK
@modelcontextprotocol/sdk
# サーバー関連
express, cors, helmet, jsonwebtoken
# SSH・Redis関連
node-ssh, ioredis, axios
# 型定義
@types/express, @types/cors, @types/jsonwebtoken
4. プロジェクト構造確立¶
/root/mcp-gateway/
├── src/
│ ├── server.ts (基本サーバー実装済み)
│ ├── auth/, managers/, security/, types/ (ディレクトリ準備済み)
├── nginx/
│ └── mcp.call2arm.com.conf (Nginx設定ファイル)
├── docker-compose.yml (開発・本番対応)
├── Dockerfile (本番用)
├── .env.example (環境変数テンプレート)
├── .gitignore (適切な除外設定)
└── README.md (プロジェクト文書)
5. 動作確認完了¶
-
開発サーバー:
npm run dev起動確認済み -
TypeScriptビルド:
npm run build正常動作 -
エンドポイント:
/health,/.well-known/oauth-authorization-server実装済み
📊 成果物¶
- ✅ TypeScript開発環境完成
- ✅ プロジェクト構造確立
- ✅ 基本サーバー動作確認
- ✅ Docker・Nginx設定準備完了
- ✅ 開発用スクリプト設定完了
🚀 次のステップ¶
Phase 1の実装準備完了。#316: OAuth-1 Discovery Endpoint実装から開始可能。
作業時間: 4時間で完了
ステータス: Ready for Phase 1 Implementation
Redmine Admin さんが約17時間前に更新
- ステータス を 新規 から 解決 に変更
Setup-1 作業完了報告¶
✅ Git管理開始¶
-
Repository:
/root/mcp-gateway/.git -
Initial Commit:
0220b39feat: Setup-1 TypeScript開発環境完了 - Files: 12ファイルコミット完了
📊 作業サマリー¶
- 作業時間: 4時間
- 成果物: TypeScript開発環境完全構築
- ステータス: ✅ 完了
- 次工程: Phase 1 OAuth実装準備完了
🚀 準備完了項目¶
- ✅ Node.js + TypeScript環境
- ✅ MCP SDK + 依存関係
- ✅ プロジェクト構造
- ✅ Docker + Nginx設定
- ✅ 基本サーバー動作確認
- ✅ Git管理体制確立
Next: #316 OAuth-1 Discovery Endpoint実装開始可能
操作