MCP Server for Lychee Redmine

# Technology Stack

## Architecture

- **プロトコル**: Model Context Protocol (MCP) - JSON-RPC 2.0ベースの標準プロトコル
- **通信方式**: stdio経由の双方向通信
- **統合パターン**: REST API経由での外部システム統合（Lychee Redmine）

## Core Technologies

- **Language**: TypeScript (strict mode)
- **Runtime**: Node.js 20+
- **Protocol**: MCP (Model Context Protocol)

## Key Libraries

- **MCP SDK**: MCPプロトコル実装用の公式SDK
- **HTTP Client**: Lychee Redmine REST API通信用（axios/node-fetch）
- **Validation**: JSON Schemaベースのパラメータバリデーション

## Development Standards

### Type Safety
- TypeScript strict mode必須
- `any`の使用禁止
- Lychee/Redmine APIレスポンスの包括的な型定義を提供

### Code Quality
- ESLintとPrettierによる自動フォーマット
- 一貫したコーディング規約の適用

### Testing
- ユニットテストとインテグレーションテストの両方を実装
- 外部API呼び出しのモック化

## Development Environment

### Required Tools
- Node.js 20以上
- TypeScript 5.x
- ESLint + Prettier

### Common Commands
```bash
# Dev: npm run dev
# Build: npm run build
# Test: npm run test
```

## Key Technical Decisions

### エラーハンドリング戦略
- API呼び出し失敗時は指数バックオフでリトライ（最大3回）
- エラーは分かりやすい形式でクライアントに返す
- 詳細なログ（DEBUG/INFO/WARN/ERROR）を記録

### セキュリティ原則
- APIキーは環境変数または暗号化ストレージで管理（平文保存禁止）
- HTTPS経由でのAPI通信
- 入力パラメータのサニタイゼーション必須

### パフォーマンス最適化
- 大量データ取得時はページネーション使用
- 並行処理の適切な実装

### 設定管理
- 環境変数と設定ファイル（JSON/YAML）の両方をサポート
- 複数インスタンス対応（Lychee Redmine）

---
_Document standards and patterns, not every dependency_