TTS-MCP

# テスト実装について

このドキュメントでは、tts-mcpリポジトリのテスト実装について説明します。

## テスト環境

- **フレームワーク**: Jest
- **モックライブラリ**: mock-fs, sinon, nock
- **テストタイプ**: ユニットテスト、統合テスト

## テストファイル構造

- `test/utils.test.ts` - ユーティリティ関数のテスト
- `test/api.test.ts` - OpenAI API関連機能のテスト
- `test/mcp-server.test.ts` - MCPサーバー機能のユニットテスト
- `test/integration.test.ts` - CLIと基本機能の統合テスト（デフォルトではスキップ）
- `test/mcp-client.test.ts` - MCPクライアント・サーバー間の統合テスト（デフォルトではスキップ）
- `test/helpers/mcp-test-helpers.ts` - 統合テスト用のヘルパー関数

## 実行方法

```bash
# 通常のテスト実行（ユニットテストのみ）
npm test

# カバレッジレポート生成
npm run test:coverage

# すべての統合テスト実行（実際のAPIを使用するため注意）
INTEGRATION_TEST=true npm test

# 特定の統合テストのみ実行
INTEGRATION_TEST=true npm test -- test/integration.test.ts
INTEGRATION_TEST=true npm test -- test/mcp-client.test.ts
```

## 新規追加された統合テスト

### MCPサーバー起動テスト (`integration.test.ts`)
- MCPサーバーが正常に起動することを確認
- コマンドラインオプションの動作を確認
- バージョン情報とヘルプの表示を確認

### MCPクライアント・サーバー連携テスト (`mcp-client.test.ts`)
- MCPサーバーとクライアント間の接続を確認
- ツールの登録と検出を確認
- text-to-speechツールの呼び出しを確認（実際のAPIキーが必要）

## ヘルパー関数

`test/helpers/mcp-test-helpers.ts` には以下のヘルパー関数が用意されています：

- `startMcpServer()`: テスト用MCPサーバーを起動
- `createMcpClient()`: テスト用MCPクライアントを作成して接続
- `cleanupFile()`: テストで生成したファイルを削除

## テストカバレッジ

現在のテストカバレッジ状況：

- **utils.ts**: 95% 以上（非常に良好）
- **api.ts**: 76%（改善の余地あり）
- **mcp-server.ts**: 40%（改善中）
- **index.ts**: 0%（テスト未実装）

## 今後の改善点

1. **MCPサーバーテストの強化**:
   - サーバーとクライアント間の統合テストの拡充
   - エラー発生時の挙動をテスト

2. **index.tsのテスト追加**:
   - メインエントリーポイントのテストを実装

3. **CI/CD連携**:
   - GitHub ActionsなどのCI環境でテストを自動実行
   - テスト実行をGit hookに組み込む

## 注意事項

- 統合テストを実行するには `INTEGRATION_TEST=true` 環境変数を設定して実行してください
- テスト実行時は `.env` ファイルの実際のAPIキーが使用されないよう注意してください
- 統合テストを実行する場合は、必ずテスト用のAPIキーを使用してください
- APIキーがない場合、一部のテストは自動的にスキップされます