whisper-windows-mcp 2.2.2 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. package/{LICENSE-COMMERCIAL.md → COMMERCIAL-LICENSE.md} +58 -58
  2. package/LICENSE +40 -40
  3. package/PRIVACY.es.md +192 -135
  4. package/PRIVACY.id.md +192 -135
  5. package/PRIVACY.ja.md +192 -135
  6. package/PRIVACY.ko.md +192 -135
  7. package/PRIVACY.md +192 -135
  8. package/PRIVACY.pl.md +192 -135
  9. package/PRIVACY.pt-BR.md +192 -135
  10. package/PRIVACY.ro.md +192 -135
  11. package/PRIVACY.uk.md +192 -135
  12. package/PRIVACY.vi.md +192 -135
  13. package/README.es.md +74 -48
  14. package/README.id.md +77 -40
  15. package/README.ja.md +100 -72
  16. package/README.ko.md +63 -37
  17. package/README.md +76 -39
  18. package/README.pl.md +77 -40
  19. package/README.pt-BR.md +71 -45
  20. package/README.ro.md +78 -41
  21. package/README.uk.md +77 -40
  22. package/README.vi.md +67 -41
  23. package/ROADMAP.es.md +110 -48
  24. package/ROADMAP.id.md +77 -104
  25. package/ROADMAP.ja.md +84 -123
  26. package/ROADMAP.ko.md +73 -97
  27. package/ROADMAP.pl.md +104 -44
  28. package/ROADMAP.pt-BR.md +78 -102
  29. package/ROADMAP.ro.md +102 -44
  30. package/ROADMAP.uk.md +65 -97
  31. package/ROADMAP.vi.md +78 -102
  32. package/SECURITY.es.md +64 -47
  33. package/SECURITY.id.md +64 -47
  34. package/SECURITY.ja.md +64 -47
  35. package/SECURITY.ko.md +64 -47
  36. package/SECURITY.md +21 -4
  37. package/SECURITY.pl.md +64 -47
  38. package/SECURITY.pt-BR.md +64 -47
  39. package/SECURITY.ro.md +64 -47
  40. package/SECURITY.uk.md +64 -47
  41. package/SECURITY.vi.md +64 -47
  42. package/TROUBLESHOOTING.es.md +309 -323
  43. package/TROUBLESHOOTING.id.md +333 -323
  44. package/TROUBLESHOOTING.ja.md +399 -286
  45. package/TROUBLESHOOTING.ko.md +309 -323
  46. package/TROUBLESHOOTING.pl.md +355 -323
  47. package/TROUBLESHOOTING.pt-BR.md +309 -323
  48. package/TROUBLESHOOTING.ro.md +355 -323
  49. package/TROUBLESHOOTING.uk.md +369 -323
  50. package/TROUBLESHOOTING.vi.md +309 -323
  51. package/dist/index.js +591 -216
  52. package/package.json +45 -45
  53. package/patch_roadmaps.py +0 -72
package/PRIVACY.ja.md CHANGED
@@ -1,135 +1,192 @@
1
- # プライバシーアーキテクチャ — whisper-windows-mcp
2
-
3
- このドキュメントでは、どのデータがマシンに留まり、どのデータがマシンの外に出るか、そして規制対象または機密性の高いコンテンツに対してツールをどのように設定するかを説明します。
4
-
5
- ---
6
-
7
- ## コアな保証
8
-
9
- whisper-windows-mcpはローカルファーストのアーキテクチャに基づいて構築されています。**音声・動画ファイルはマシンの外に出ることは一切ありません。** 文字起こしはwhisper.cppを使用してすべてローカルハードウェア上で実行されます — 文字起こし自体にクラウドサービス、インターネット接続、APIコールは不要です。
10
-
11
- この保証はメディアファイルに対して無条件に適用されます。
12
-
13
- ---
14
-
15
- ## 常にローカルに留まるデータ
16
-
17
- | データ | マシンの外に出るか |
18
- |---|---|
19
- | 音声ファイル | ❌ 出ない |
20
- | 動画ファイル | ❌ 出ない |
21
- | Whisperモデルファイル | ❌ 出ない |
22
- | 一時WAV変換ファイル | ❌ 出ない(文字起こし後に削除) |
23
- | バッチ状態・ジョブファイル | ❌ 出ない |
24
- | ディスク上のトランスクリプト`.txt` / `.srt`ファイル | ❌ 出ない |
25
-
26
- ---
27
-
28
- ## デフォルトの動作でマシンの外に出る可能性があるデータ
29
-
30
- ツールレスポンスにトランスクリプトテキストが含まれる場合、そのテキストはClaude Desktopに返され、AnthropicのAPIで処理されます。これは標準的なMCPの動作です — テキストはローカルMCPサーバーからClaudeのモデルへネットワークを通じて送信されます。
31
-
32
- | データ | マシンの外に出るか |
33
- |---|---|
34
- | ツールレスポンスで返されるトランスクリプトテキスト | ✅ デフォルトで出る |
35
- | Claudeにファイルとして直接アップロードされるトランスクリプト | ✅ 出る(MCPの外側) |
36
-
37
- このギャップは、ツールの「データはマシンの外に出ない」という保証とトランスクリプトの分析や要約をClaudeに依頼した際の実際のデータフローの間に存在します。YouTubeの動画、ポッドキャスト、ストリーミング録画などの公開コンテンツを文字起こしするほとんどのユーザーには、この区別は影響しません。
38
-
39
- プライベート、機密性の高い、または規制対象の録音を扱うユーザーにとっては、この区別が重要です。
40
-
41
- ---
42
-
43
- ## プライバシーモード(計画中 — 未実装)
44
-
45
- 将来のリリースで`WHISPER_PRIVACY_MODE`環境変数が計画されています。有効化時:
46
-
47
- - すべてのツールレスポンスはメタデータのみを返します:ファイル名、時間、単語数、完了状態
48
- - どのツールレスポンスにもトランスクリプトテキストは含まれません
49
- - Claudeはトランスクリプトの内容を読み取り、分析、または中継できません
50
- - トランスクリプトはディスク上のローカル`.txt`ファイルとしてのみ存在します
51
-
52
- このモードは医療、法律、金融、および企業向けデプロイメントで、トランスクリプトコンテンツをいかなる状況でもローカル環境の外に出さないことが必要な場合に設計されています。
53
-
54
- **計画中の設定:**
55
-
56
- ```json
57
- {
58
- "mcpServers": {
59
- "whisper": {
60
- "command": "npx",
61
- "args": ["-y", "whisper-windows-mcp"],
62
- "env": {
63
- "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
64
- "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
65
- "WHISPER_PRIVACY_MODE": "true"
66
- }
67
- }
68
- }
69
- }
70
- ```
71
-
72
- この機能がリリースされるまでの対応:Claudeのターンを通じて送信せずにトランスクリプトコンテンツを分析する必要がある場合は、`.txt`ファイルをローカルのテキストエディターや処理ツールで直接開いてください。
73
-
74
- ---
75
-
76
- ## 規制産業向けガイダンス
77
-
78
- 以下は一般的な情報のみです。このツールの作者は法律の専門家ではありません。ユーザーは適用される法律・規制へのコンプライアンスに対して単独で責任を負います。規制対象コンテンツを文字起こしする前に、不明な点がある場合は資格を持った法律の専門家にご相談ください。
79
-
80
- ### HIPAA(米国 — 医療)
81
- 医療提供者、保険会社、およびそれらのビジネスアソシエイトは、業務提携契約(BAA)なしに保護対象保健情報(PHI)を無許可の第三者に送信することを禁止されています。AnthropicはClaudeの消費者向けAPI利用に対してHIPAA BAAを提供していません。
82
-
83
- **対象となるユースケース:** 患者の相談、臨床メモ、セラピーセッション、保険請求の電話、病院の管理録音。
84
-
85
- **現在の推奨事項:** 患者の音声を文字起こしし、そのトランスクリプトをClaudeで要約または分析することは、組織が準拠した処理体制を確立していない限り避けてください。`WHISPER_PRIVACY_MODE`が利用可能になったら使用してください。
86
-
87
- ### GDPR(EU/EEA)
88
- EU居住者の個人データは、明示的な同意と適法な処理根拠なしに第三者処理者に転送できません。名前、場所、または識別情報を含むトランスクリプトテキストはGDPRの下で個人データに該当します。
89
-
90
- **対象となるユースケース:** インタビュー、会議、コールセンターの録音、EU居住者が関与する法的手続き。
91
-
92
- **現在の推奨事項:** EU居住者の個人データを含むトランスクリプトをClaudeにアップロードすることは、あなたの役割と処理目的によってはGDPRへの影響がある可能性があることに注意してください。
93
-
94
- ### 弁護士・依頼者特権(米国、英国、オーストラリア、およびほとんどのコモンロー法域)
95
- 弁護士と依頼者の間のコミュニケーションは法的に特権が与えられています。無許可の第三者への開示は特権を放棄する可能性があります。商業的なAI APIで処理された場合に弁護士・依頼者のコミュニケーションを保護する確立された法的先例は存在しません。
96
-
97
- **対象となるユースケース:** 法的陳述、依頼者との相談、内部戦略の録音、証人インタビュー。
98
-
99
- **現在の推奨事項:** 特権的なコミュニケーションを文字起こしする弁護士は、特権への影響について独立した法的レビューなしに、それらのトランスクリプトをClaudeによる分析のためにアップロードすべきではありません。
100
-
101
- ### FERPA(米国 — 教育)
102
- 生徒の教育記録は保護されています。学校と大学は同意なしに識別可能な生徒情報を第三者に開示できません。
103
-
104
- **対象となるユースケース:** 録音された講義、学生カウンセリングセッション、学術的な聴聞会、IEP会議。
105
-
106
- ### SOX(米国 — 上場企業)
107
- 上場企業の財務コミュニケーションは記録保持と機密性の要件の対象です。重要な未公開情報(MNPI)は選択的に開示できません。
108
-
109
- **対象となるユースケース:** 決算発表の録音、取締役会会議のトランスクリプト、投資家とのコミュニケーション、内部財務戦略の議論。
110
-
111
- ### PCI-DSS
112
- 決済カードデータは安全でない環境で保存または送信できません。取引中のカード番号の音声録音はスコープ内となります。
113
-
114
- **対象となるユースケース:** コールセンターの録音、決済処理を含むカスタマーサービスの電話。
115
-
116
- ### 企業秘密 / NDA保護
117
- 機密ビジネス情報、独自の公式、未発表の製品詳細、および人事情報は契約または法律によって保護される場合があります。
118
-
119
- **対象となるユースケース:** 企業戦略会議、R&Dの議論、M&Aのデューデリジェンス通話、HR手続き。
120
-
121
- ---
122
-
123
- ## Claudeへのトランスクリプトファイルの直接アップロード
124
-
125
- トランスクリプト`.txt`ファイルをClaude Desktopにファイル添付として直接アップロードする場合(MCPツールを介さずに)、MCPサーバーには可視性がなく、プライバシーコントロールを適用できません。
126
-
127
- トランスクリプトをClaudeに直接アップロードすることは、音声コンテンツをAnthropicに送信することと同等です。プライバシーモードや将来のMCPレベルの保護は、直接ファイルアップロードには適用されません。
128
-
129
- 規制対象コンテンツを扱うユーザーはトランスクリプトをClaudeに直接アップロードしてはなりません。規制対象コンテンツの安全な分析パスは、外部にコンテンツを送信しないローカル処理ツールのみです。
130
-
131
- ---
132
-
133
- ## プライバシーに関する懸念の報告
134
-
135
- ここに記載されていないプライバシー問題またはアーキテクチャのギャップを発見した場合は、公開のIssueを開かずに、GitHubのプライベート脆弱性レポートを使用してください。報告手順については[SECURITY.md](SECURITY.md)を参照してください。
1
+ # プライバシーアーキテクチャ — whisper-windows-mcp
2
+
3
+ このドキュメントでは、どのデータがマシンに留まり、どのデータがマシンの外に出るか、そして規制対象または機密性の高いコンテンツに対してツールをどのように設定するかを説明します。
4
+
5
+ ---
6
+
7
+ ## コアな保証
8
+
9
+ whisper-windows-mcpはローカルファーストのアーキテクチャに基づいて構築されています。**音声・動画ファイルはマシンの外に出ることは一切ありません。** 文字起こしはwhisper.cppを使用してすべてローカルハードウェア上で実行されます — 文字起こし自体にクラウドサービス、インターネット接続、APIコールは不要です。
10
+
11
+ この保証はメディアファイルに対して無条件に適用されます。
12
+
13
+ ---
14
+
15
+ ## 常にローカルに留まるデータ
16
+
17
+ | データ | マシンの外に出るか |
18
+ |---|---|
19
+ | 音声ファイル | ❌ 出ない |
20
+ | 動画ファイル | ❌ 出ない |
21
+ | Whisperモデルファイル | ❌ 出ない |
22
+ | 一時WAV変換ファイル | ❌ 出ない(文字起こし後に削除) |
23
+ | バッチ状態・ジョブファイル | ❌ 出ない |
24
+ | ディスク上のトランスクリプト`.txt` / `.srt` / `.vtt`ファイル | ❌ 出ない |
25
+
26
+ ---
27
+
28
+ ## デフォルトの動作でマシンの外に出る可能性があるデータ(標準モード)
29
+
30
+ ツールレスポンスにトランスクリプトテキストが含まれる場合、そのテキストはClaude Desktopに返され、AnthropicのAPIで処理されます。これは標準的なMCPの動作です — テキストはローカルMCPサーバーからClaudeのモデルへネットワークを通じて送信されます。
31
+
32
+ | データ | マシンの外に出るか |
33
+ |---|---|
34
+ | ツールレスポンスで返されるトランスクリプトテキスト | ✅ 標準モードでは出る |
35
+ | Claudeにファイルとして直接アップロードされるトランスクリプト | ✅ 出る(MCPの外側 — プライバシー制御は適用されない) |
36
+
37
+ このギャップは、ツールの「データはマシンの外に出ない」という保証とトランスクリプトの分析や要約をClaudeに依頼した際の実際のデータフローの間に存在します。YouTubeの動画、ポッドキャスト、ストリーミング録画などの公開コンテンツを文字起こしするほとんどのユーザーには、この区別は影響しません。
38
+
39
+ プライベート、機密性の高い、または規制対象の録音を扱うユーザーにとっては、この区別が重要です。
40
+
41
+ ---
42
+
43
+ ## プライバシーモード
44
+
45
+ `WHISPER_PRIVACY_MODE`はすべてのツールレスポンスをメタデータのみに制限します。有効化時:
46
+
47
+ - ツールレスポンスは以下のみを返します:ファイル名、単語数、保存パス、完了状態
48
+ - どのツールレスポンスにもトランスクリプトテキストは含まれません
49
+ - Claudeはトランスクリプトの内容を読み取り、分析、または中継できません
50
+ - トランスクリプトはディスク上のローカルファイルとしてのみ存在します
51
+
52
+ プライバシーモードは医療、法律、財務、および企業向けデプロイメントで、トランスクリプトコンテンツをいかなる状況でもローカル環境の外に出さないことが必要な場合に設計されています。
53
+
54
+ ### グローバルに有効化(環境変数)
55
+
56
+ `claude_desktop_config.json`に設定:
57
+
58
+ ```json
59
+ {
60
+ "mcpServers": {
61
+ "whisper": {
62
+ "command": "npx",
63
+ "args": ["-y", "whisper-windows-mcp"],
64
+ "env": {
65
+ "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
66
+ "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
67
+ "WHISPER_PRIVACY_MODE": "true"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ 有効化にはClaude Desktopの再起動が必要です。
75
+
76
+ ### per-callで有効化(再起動不要)
77
+
78
+ 任意の文字起こしツールに`privacy_mode=true`を直接渡す:
79
+
80
+ - *「このファイルをプライバシーモードで文字起こしして」*
81
+ - *「このフォルダでバッチを開始して、privacy_mode=true」*
82
+ - *「job_123の進捗を確認して、privacy_mode=true」*
83
+
84
+ per-callパラメーターはグローバル環境変数をどちらの方向にも上書きします。`WHISPER_PRIVACY_MODE=true`がグローバルに設定されていても、単一の呼び出しに対して`privacy_mode=false`を渡すことで無効化できます。
85
+
86
+ ### プライバシーモードゲートの動作
87
+
88
+ プライバシーモードが有効な場合、**操作ごとに**確認開示が表示されます。これは意図的な動作です — 規制へのコンプライアンスには、セッション単位ではなく操作ごとのインフォームドコンセントが必要です。
89
+
90
+ 開示テキストは毎回同一です。これは意図的な設計です。機密性の高いコンテンツを扱う場合は、各操作を明示的に確認すべきです。
91
+
92
+ プライバシーモードでの`start_batch`:バッチ開始前に一度だけ確認が必要です。その後すべてのファイルは無人で処理されます。どの時点でもトランスクリプトテキストは返されません — バッチ進捗メタデータのみが返されます。
93
+
94
+ ---
95
+
96
+ ## 同意ゲート(標準モード)
97
+
98
+ プライバシーモードが有効でない場合、セッション内で初めてトランスクリプトテキストがClaudeのAPIに返される前に、一度だけセッション開示が表示されます。
99
+
100
+ 開示には以下が含まれます:
101
+ - トランスクリプトテキストがAnthropicのAPIに送信されること
102
+ - コンテンツに適用される可能性のある規制フレームワーク
103
+ - 必要に応じてプライバシーモードを有効化する方法
104
+ - 機密性のないコンテンツに対してゲートを永続的に抑制する方法
105
+
106
+ 確認後、セッション中はゲートは再度表示されません。Claude Desktopを再起動するとセッションがリセットされ、次のトランスクリプト返却呼び出し時にゲートが再度表示されます。
107
+
108
+ **バックグラウンドジョブの場合:** 同意ゲートは`transcribe_audio`呼び出し時ではなく、`check_progress`完了時に表示されます。呼び出し時点では、トランスクリプトテキストはまだ存在しません — ゲートはトランスクリプトテキストが初めてAPIに返される瞬間に表示されます。
109
+
110
+ ### ゲートを永続的にスキップする
111
+
112
+ 機密性のないコンテンツを定期的に文字起こしし、リマインダーが不要になった場合は、設定に以下を追加してください:
113
+
114
+ ```json
115
+ "WHISPER_CONSENT_ACKNOWLEDGED": "true"
116
+ ```
117
+
118
+ これはプライバシーモードが有効な場合には効果がありません。プライバシーモードはこの設定に関わらず常に表示される独自の操作ごとのゲートを使用します。
119
+
120
+ ---
121
+
122
+ ## データフローのまとめ
123
+
124
+ | モード | 音声 | トランスクリプトテキスト | 確認が必要 |
125
+ |---|---|---|---|
126
+ | 標準 | ローカルのみ | AnthropicのAPIに送信 | セッションに1回(同意ゲート) |
127
+ | プライバシーモード(環境変数) | ローカルのみ | 送信されない | 操作ごと |
128
+ | プライバシーモード(per-call) | ローカルのみ | この呼び出しでは送信されない | この操作のみ |
129
+ | `WHISPER_CONSENT_ACKNOWLEDGED=true` | ローカルのみ | AnthropicのAPIに送信 | なし(スキップ) |
130
+
131
+ ---
132
+
133
+ ## Claudeへのトランスクリプトファイルの直接アップロード
134
+
135
+ トランスクリプト`.txt`ファイルをClaudeにファイル添付として直接アップロードする場合(MCPツールを介さずに)、MCPサーバーには可視性がなく、プライバシーコントロールを適用できません。
136
+
137
+ トランスクリプトをClaudeに直接アップロードすることは、音声コンテンツをAnthropicに送信することと同等です。プライバシーモードおよびすべてのMCPレベルの保護は、直接ファイルアップロードでは完全にバイパスされます。
138
+
139
+ 規制対象コンテンツを扱うユーザーはトランスクリプトをClaudeに直接アップロードしてはなりません。規制対象コンテンツの唯一の安全な分析パスは、コンテンツを外部に送信しないローカル処理ツールです。
140
+
141
+ ---
142
+
143
+ ## 規制産業向けガイダンス
144
+
145
+ 以下は一般的な情報のみです。このツールの作者は法律の専門家ではありません。ユーザーは適用される法律・規制へのコンプライアンスに対して単独で責任を負います。規制対象コンテンツを文字起こしする前に、不明な点がある場合は資格を持った法律の専門家にご相談ください。
146
+
147
+ ### HIPAA(米国 — 医療)
148
+ 医療提供者、保険会社、およびそれらのビジネスアソシエイトは、業務提携契約(BAA)なしに保護対象保健情報(PHI)を無許可の第三者に送信することを禁止されています。AnthropicはClaudeの消費者向けAPI利用に対してHIPAA BAAを提供していません。
149
+
150
+ **対象となるユースケース:** 患者の相談、臨床メモ、セラピーセッション、保険請求の電話、病院の管理録音。
151
+
152
+ **推奨事項:** 患者の音声を文字起こしする前に`WHISPER_PRIVACY_MODE=true`を有効にしてください。セッション中に無効化しないでください。
153
+
154
+ ### GDPR(EU/EEA)
155
+ EU居住者の個人データは、明示的な同意と適法な処理根拠なしに第三者処理者に転送できません。名前、場所、または識別情報を含むトランスクリプトテキストはGDPRの下で個人データに該当します。
156
+
157
+ **対象となるユースケース:** インタビュー、会議、コールセンターの録音、EU居住者が関与する法的手続き。
158
+
159
+ **推奨事項:** EU/EEA居住者の個人データを含む可能性のある録音にはプライバシーモードを有効にしてください。
160
+
161
+ ### 弁護士・依頼者特権(米国、英国、オーストラリア、およびほとんどのコモンロー法域)
162
+ 弁護士と依頼者の間のコミュニケーションは法的に特権が与えられています。無許可の第三者への開示は特権を放棄する可能性があります。商業的なAI APIで処理された場合に弁護士・依頼者のコミュニケーションを保護する確立された法的先例は存在しません。
163
+
164
+ **対象となるユースケース:** 法的陳述、依頼者との相談、内部戦略の録音、証人インタビュー。
165
+
166
+ **推奨事項:** 特権的なコミュニケーションを文字起こしする弁護士はプライバシーモードを有効にしてください。分析にも無効化しないでください — 特権コンテンツにはローカルのテキストエディターや処理ツールを使用してください。
167
+
168
+ ### FERPA(米国 — 教育)
169
+ 生徒の教育記録は保護されています。学校と大学は同意なしに識別可能な生徒情報を第三者に開示できません。
170
+
171
+ **対象となるユースケース:** 録音された講義、学生カウンセリングセッション、学術的な聴聞会、IEP会議。
172
+
173
+ ### SOX(米国 — 上場企業)
174
+ 上場企業の財務コミュニケーションは記録保持と機密性の要件の対象です。重要な未公開情報(MNPI)は選択的に開示できません。
175
+
176
+ **対象となるユースケース:** 決算発表の録音、取締役会会議のトランスクリプト、投資家とのコミュニケーション、内部財務戦略の議論。
177
+
178
+ ### PCI-DSS
179
+ 決済カードデータは安全でない環境で保存または送信できません。取引中のカード番号の音声録音はスコープ内となります。
180
+
181
+ **対象となるユースケース:** コールセンターの録音、決済処理を含むカスタマーサービスの電話。
182
+
183
+ ### 企業秘密 / NDA保護
184
+ 機密ビジネス情報、独自の公式、未発表の製品詳細、および人事情報は契約または法律によって保護される場合があります。
185
+
186
+ **対象となるユースケース:** 企業戦略会議、R&Dの議論、M&Aのデューデリジェンス通話、HR手続き。
187
+
188
+ ---
189
+
190
+ ## プライバシーに関する懸念の報告
191
+
192
+ ここに記載されていないプライバシー問題またはアーキテクチャのギャップを発見した場合は、公開のIssueを開かずに、GitHubのプライベート脆弱性レポートを使用してください。報告手順については[SECURITY.md](SECURITY.md)を参照してください。