whisper-windows-mcp 2.0.0 → 2.2.1

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,42 @@
+---
+name: Bug report
+about: Something isn't working correctly
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## What happened
+
+<!-- Describe what went wrong -->
+
+## Steps to reproduce
+
+1. 
+2. 
+3. 
+
+## Expected behavior
+
+<!-- What should have happened instead -->
+
+## Environment
+
+- **OS:** Windows [version — run `winver`]
+- **Node.js:** [run `node --version`]
+- **whisper-windows-mcp version:** [shown in Claude Desktop Settings → Developer]
+- **GPU:** [model name]
+- **Vulkan build:** Yes / No
+- **Model:** [e.g. ggml-medium.en.bin, ggml-large-v3.bin]
+
+## Error output
+
+<!-- Paste any error messages here -->
+
+```
+error output here
+```
+
+## Additional context
+
+<!-- Anything else that might help — file format, file duration, language, etc. -->

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,29 @@
+---
+name: Feature request
+about: Suggest a new feature or improvement
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## What problem would this solve
+
+<!-- Describe the use case. What are you trying to do that isn't possible or is difficult right now? -->
+
+## Proposed solution
+
+<!-- How would you like this to work? Be as specific as you can. -->
+
+## Alternatives considered
+
+<!-- Have you tried other approaches? What didn't work? -->
+
+## Hardware context
+
+<!-- Relevant if this is GPU/model related -->
+- GPU: 
+- Model size you're using:
+
+## Additional context
+
+<!-- Anything else — links to similar implementations, whisper.cpp flags that might support this, etc. -->

package/.github/ISSUE_TEMPLATE/gpu_test_result.md

@@ -0,0 +1,32 @@
+---
+name: GPU test result
+about: Share your GPU acceleration test results to help other users
+title: '[GPU] '
+labels: hardware-report
+assignees: ''
+---
+
+## Hardware
+
+- **GPU:** 
+- **VRAM:** 
+- **CPU:** 
+- **RAM:** 
+
+## Test
+
+- **Model used:** [e.g. ggml-medium.en.bin, ggml-large-v3.bin]
+- **File duration:** [e.g. 5 minutes]
+- **Language:** 
+
+## Results
+
+- **GPU utilization during transcription:** [e.g. 20%]
+- **Time to complete:** 
+- **CPU utilization during transcription:** 
+- **Vulkan build:** Yes / No
+- **Any issues:** 
+
+## Notes
+
+<!-- Anything else worth knowing for users with similar hardware -->

package/.github/pull_request_template.md

@@ -0,0 +1,28 @@
+## What this PR does
+
+<!-- Brief description of the change -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation update
+- [ ] Performance improvement
+- [ ] Other
+
+## Testing
+
+- [ ] Tested on Windows
+- [ ] Built successfully (`npm run build`)
+- [ ] Tested in Claude Desktop with a real audio file
+
+## Checklist
+
+- [ ] Version bumped in `package.json` and `src/index.ts`
+- [ ] README updated if new tools or parameters added
+- [ ] TROUBLESHOOTING.md updated if fixing a known issue
+- [ ] No new external runtime dependencies added
+
+## Related issues
+
+<!-- Closes #xxx -->

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,30 @@
+# Code of Conduct
+
+## Our standards
+
+This project is built to be useful to a wide range of people — developers, journalists, legal professionals, researchers, language students, video editors, and anyone else who needs local audio transcription on Windows.
+
+We expect contributors and community members to:
+
+- Be respectful and constructive in issues and pull requests
+- Focus feedback on the work, not the person
+- Accept that different people have different use cases and hardware setups
+- Help newcomers get set up — not everyone is a developer
+
+## Unacceptable behavior
+
+- Harassment, personal attacks, or discriminatory language
+- Dismissing bug reports because they involve non-English languages or non-NVIDIA hardware
+- Spam or off-topic promotion
+
+## Enforcement
+
+Issues or pull requests that violate these standards will be closed. Repeat violations may result in being blocked from the repository.
+
+## Reporting
+
+If you experience or witness unacceptable behavior, open a private vulnerability report or contact the maintainer directly through GitHub.
+
+---
+
+This Code of Conduct is intentionally minimal. The goal is a functional, welcoming project — not bureaucracy.

package/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing to whisper-windows-mcp
+
+Thanks for your interest in contributing. This is a Windows-native MCP server for local audio transcription — contributions that improve Windows compatibility, GPU support, and usability for non-technical users are especially welcome.
+
+---
+
+## Before you start
+
+Check the [open issues](https://github.com/eviscerations/whisper-windows-mcp/issues) before starting work to avoid duplicating effort. If you want to work on something not listed, open an issue first to discuss it.
+
+See [ROADMAP.md](ROADMAP.md) for planned features and known bugs.
+
+---
+
+## What we need most
+
+- **GPU acceleration testing** — if you've tested on NVIDIA, Intel Arc, or AMD hardware not listed in the README, please share your results (GPU model, VRAM, model size, observed throughput)
+- **Bug reports with reproduction steps** — especially for Windows-specific issues
+- **Multilingual testing** — results with non-English audio and the large-v3 model
+- **Documentation improvements** — especially for non-English speakers
+
+---
+
+## Development setup
+
+```
+git clone https://github.com/eviscerations/whisper-windows-mcp
+cd whisper-windows-mcp
+npm install
+npm run build
+```
+
+The server is a single TypeScript file at `src/index.ts`. The compiled output goes to `dist/`.
+
+To test locally, update your `claude_desktop_config.json` to point at the local build:
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "node",
+      "args": ["C:\\path\\to\\whisper-windows-mcp\\dist\\index.js"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-medium.en.bin"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop after each build to pick up changes.
+
+---
+
+## Pull request guidelines
+
+- Keep PRs focused — one fix or feature per PR
+- Test on Windows (this is a Windows-only tool)
+- If adding a new tool, update the tool list in README.md
+- If fixing a bug, add a note to TROUBLESHOOTING.md if it's something other users will hit
+- Bump the version in `package.json` and the version string in `src/index.ts` before submitting
+
+---
+
+## Code style
+
+- TypeScript, no external runtime dependencies beyond `@modelcontextprotocol/sdk`
+- All file I/O must handle non-ASCII filenames (Unicode, Japanese, Chinese, emoji)
+- New tools go in the `CallToolRequestSchema` handler following the existing pattern
+- Error messages should be actionable — tell the user what to do, not just what went wrong
+
+---
+
+## Reporting bugs
+
+Open an issue with:
+- Your OS version (`winver`)
+- Node.js version (`node --version`)
+- whisper-windows-mcp version
+- GPU model and whether you're using the Vulkan build
+- Exact steps to reproduce
+- Full error output if available
+
+---
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the MIT license.

package/PRIVACY.es.md

@@ -0,0 +1,135 @@
+# Arquitectura de Privacidad — whisper-windows-mcp
+
+Este documento describe qué datos permanecen en tu máquina, qué datos la abandonan y cómo configurar la herramienta para contenido regulado o sensible.
+
+---
+
+## La garantía central
+
+whisper-windows-mcp está construido sobre una arquitectura que prioriza lo local. **Los archivos de audio y video nunca salen de tu máquina.** La transcripción se ejecuta completamente en tu hardware usando whisper.cpp — ningún servicio en la nube, conexión a internet ni llamada a API están involucrados en la transcripción en sí.
+
+Esta garantía es incondicional para archivos multimedia.
+
+---
+
+## Datos que siempre permanecen locales
+
+| Datos | ¿Sale de la máquina? |
+|---|---|
+| Archivos de audio | ❌ Nunca |
+| Archivos de video | ❌ Nunca |
+| Archivos de modelo Whisper | ❌ Nunca |
+| Archivos WAV de conversión temporal | ❌ Nunca (eliminados tras la transcripción) |
+| Archivos de estado de lotes y tareas | ❌ Nunca |
+| Archivos de transcripción `.txt` / `.srt` en disco | ❌ Nunca |
+
+---
+
+## Datos que pueden salir de la máquina (comportamiento predeterminado)
+
+Cuando una respuesta de herramienta incluye texto de transcripción, ese texto es devuelto a Claude Desktop y procesado por la API de Anthropic. Este es el comportamiento estándar de MCP — el texto viaja desde el servidor MCP local al modelo de Claude a través de la red.
+
+| Datos | ¿Sale de la máquina? |
+|---|---|
+| Texto de transcripción devuelto en línea en respuestas de herramientas | ✅ Sí, de forma predeterminada |
+| Texto de transcripción subido directamente a Claude como archivo | ✅ Sí (fuera del MCP) |
+
+Esta brecha existe entre la garantía "ningún dato sale de tu máquina" de la herramienta y el comportamiento real cuando le pides a Claude que lea, resuma o analice una transcripción. La mayoría de los usuarios — quienes transcriben contenido público como videos de YouTube, podcasts o grabaciones de streaming — no se ven afectados por esta distinción.
+
+Para usuarios que manejan grabaciones privadas, confidenciales o reguladas, esta distinción importa.
+
+---
+
+## Modo de Privacidad (planificado — aún no implementado)
+
+Una variable de entorno `WHISPER_PRIVACY_MODE` está planificada para un release futuro. Cuando esté activada:
+
+- Todas las respuestas de herramientas devolverán solo metadatos: nombre de archivo, duración, conteo de palabras, estado de completado
+- Ningún texto de transcripción será incluido en ninguna respuesta de herramienta
+- Claude no podrá leer, analizar ni retransmitir contenido de transcripción de ninguna forma
+- Las transcripciones existirán solo como archivos `.txt` locales en disco
+
+Este modo está diseñado para implementaciones jurídicas, médicas, financieras y corporativas donde el contenido de transcripción no debe salir del entorno local bajo ninguna circunstancia.
+
+**Configuración planificada:**
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
+        "WHISPER_PRIVACY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+Hasta que este recurso esté disponible: si necesitas analizar contenido de transcripción sin transmitirlo a la API de Claude, abre el archivo `.txt` directamente en un editor de texto local o herramienta de procesamiento.
+
+---
+
+## Orientación para sectores regulados
+
+Lo siguiente es solo información general. Los autores de esta herramienta no son abogados. Los usuarios son los únicos responsables del cumplimiento de las leyes y regulaciones aplicables. En caso de duda, consulta con un abogado calificado antes de transcribir contenido regulado.
+
+### HIPAA (EE.UU. — salud)
+Los proveedores de salud, aseguradoras y sus socios comerciales tienen prohibido transmitir Información de Salud Protegida (PHI) a terceros no autorizados sin un Acuerdo de Socio Comercial (BAA). Anthropic no ofrece HIPAA BAA para el uso de la API de consumidor de Claude.
+
+**Casos de uso afectados:** Consultas de pacientes, notas clínicas, sesiones de terapia, llamadas de reclamaciones de seguros, grabaciones administrativas de hospitales.
+
+**Recomendación actual:** No transcribas audio de pacientes y luego pidas a Claude que resuma o analice la transcripción a menos que tu organización haya establecido un arreglo de procesamiento compatible. Usa `WHISPER_PRIVACY_MODE` cuando esté disponible.
+
+### GDPR (UE/EEE)
+Los datos personales de residentes de la UE no pueden transferirse a procesadores terceros sin consentimiento explícito y base legal para el procesamiento. El texto de transcripción que contenga nombres, ubicaciones o cualquier información de identificación constituye datos personales bajo el GDPR.
+
+**Casos de uso afectados:** Entrevistas, reuniones, grabaciones de call center, procedimientos judiciales que involucren a residentes de la UE.
+
+**Recomendación actual:** Ten en cuenta que subir transcripciones que contengan datos personales de residentes de la UE a Claude puede tener implicaciones en el GDPR dependiendo de tu rol y propósito de procesamiento.
+
+### Privilegio Abogado-Cliente (EE.UU., Reino Unido, Australia y la mayoría de las jurisdicciones de derecho común)
+Las comunicaciones entre abogados y clientes son legalmente privilegiadas. La divulgación a terceros no autorizados puede renunciar al privilegio. No existe precedente legal establecido que proteja las comunicaciones abogado-cliente cuando son procesadas por APIs de IA comerciales.
+
+**Casos de uso afectados:** Deposiciones legales, consultas con clientes, grabaciones de estrategia interna, entrevistas con testigos.
+
+**Recomendación actual:** Los abogados que transcriban comunicaciones privilegiadas no deben subir esas transcripciones a Claude para análisis sin revisión legal independiente de las implicaciones para el privilegio.
+
+### FERPA (EE.UU. — educación)
+Los registros educativos de estudiantes están protegidos. Las escuelas y universidades no pueden divulgar información identificable de estudiantes a terceros sin consentimiento.
+
+**Casos de uso afectados:** Clases grabadas, sesiones de orientación de estudiantes, audiencias académicas, reuniones de IEP.
+
+### SOX (EE.UU. — empresas públicas)
+Las comunicaciones financieras de empresas públicas están sujetas a requisitos de mantenimiento de registros y confidencialidad. La información material no pública (MNPI) no puede divulgarse de forma selectiva.
+
+**Casos de uso afectados:** Grabaciones de earnings calls, transcripciones de reuniones del consejo, comunicaciones con inversores, discusiones de estrategia financiera interna.
+
+### PCI-DSS
+Los datos de tarjetas de pago no pueden almacenarse ni transmitirse en entornos no seguros. Las grabaciones de voz de números de tarjeta durante transacciones están en el alcance.
+
+**Casos de uso afectados:** Grabaciones de call center, llamadas de atención al cliente que involucren procesamiento de pagos.
+
+### Protecciones de Secreto Comercial / NDA
+La información comercial confidencial, fórmulas propietarias, detalles de productos no lanzados e información de personal pueden estar protegidos por contrato o ley.
+
+**Casos de uso afectados:** Reuniones de estrategia corporativa, discusiones de I+D, llamadas de due diligence de M&A, procedimientos de RRHH.
+
+---
+
+## Subir archivos de transcripción directamente a Claude
+
+Cuando subes un archivo de transcripción `.txt` directamente a Claude como adjunto — completamente fuera de la herramienta MCP — el servidor MCP no tiene visibilidad y no puede aplicar ningún control de privacidad.
+
+Subir una transcripción directamente a Claude es equivalente a enviar el contenido de audio a Anthropic. Ningún modo de privacidad ni protección futura a nivel de MCP se aplicará a subidas directas de archivos.
+
+Los usuarios que manejan contenido regulado no deben subir transcripciones directamente a Claude. El único camino de análisis seguro para contenido regulado son las herramientas de procesamiento local que no transmiten contenido externamente.
+
+---
+
+## Reportar preocupaciones de privacidad
+
+Si identificas un problema de privacidad o una brecha arquitectónica no cubierta aquí, usa el reporte privado de vulnerabilidades de GitHub en lugar de abrir una issue pública. Ver [SECURITY.md](SECURITY.md) para las instrucciones de reporte.

package/PRIVACY.id.md

@@ -0,0 +1,135 @@
+# Arsitektur Privasi — whisper-windows-mcp
+
+Dokumen ini menjelaskan data apa yang tetap di mesin Anda, data apa yang meninggalkan mesin, dan cara mengkonfigurasi alat untuk konten yang diatur atau sensitif.
+
+---
+
+## Jaminan Inti
+
+whisper-windows-mcp dibangun di atas arsitektur yang mengutamakan lokal. **File audio dan video tidak pernah meninggalkan mesin Anda.** Transkripsi berjalan sepenuhnya di hardware Anda menggunakan whisper.cpp — tidak ada layanan cloud, tidak ada koneksi internet, tidak ada panggilan API yang terlibat dalam transkripsi itu sendiri.
+
+Jaminan ini berlaku tanpa syarat untuk file media.
+
+---
+
+## Data yang Selalu Tersimpan Lokal
+
+| Data | Meninggalkan mesin? |
+|---|---|
+| File audio | ❌ Tidak pernah |
+| File video | ❌ Tidak pernah |
+| File model Whisper | ❌ Tidak pernah |
+| File WAV konversi sementara | ❌ Tidak pernah (dihapus setelah transkripsi) |
+| File status batch dan tugas | ❌ Tidak pernah |
+| File transkrip `.txt` / `.srt` di disk | ❌ Tidak pernah |
+
+---
+
+## Data yang Dapat Meninggalkan Mesin (perilaku default)
+
+Saat respons alat menyertakan teks transkrip, teks tersebut dikembalikan ke Claude Desktop dan diproses oleh API Anthropic. Ini adalah perilaku MCP standar — teks berpindah dari server MCP lokal ke model Claude melalui jaringan.
+
+| Data | Meninggalkan mesin? |
+|---|---|
+| Teks transkrip yang dikembalikan sebaris dalam respons alat | ✅ Ya, secara default |
+| Teks transkrip yang diunggah langsung ke Claude sebagai file | ✅ Ya (di luar MCP) |
+
+Celah ini ada antara jaminan "tidak ada data yang meninggalkan mesin" dari alat dan perilaku aktual saat Anda meminta Claude untuk membaca, meringkas, atau menganalisis transkrip. Sebagian besar pengguna — mereka yang mentranskrip konten publik seperti video YouTube, podcast, atau rekaman streaming — tidak terpengaruh oleh perbedaan ini.
+
+Bagi pengguna yang menangani rekaman pribadi, rahasia, atau yang diatur, perbedaan ini penting.
+
+---
+
+## Mode Privasi (direncanakan — belum diimplementasikan)
+
+Variabel lingkungan `WHISPER_PRIVACY_MODE` direncanakan untuk rilis mendatang. Saat diaktifkan:
+
+- Semua respons alat hanya mengembalikan metadata: nama file, durasi, jumlah kata, status penyelesaian
+- Tidak ada teks transkrip yang disertakan dalam respons alat mana pun
+- Claude tidak dapat membaca, menganalisis, atau meneruskan konten transkrip dalam bentuk apa pun
+- Transkrip hanya ada sebagai file `.txt` lokal di disk
+
+Mode ini dirancang untuk penerapan hukum, medis, keuangan, dan perusahaan di mana konten transkrip tidak boleh meninggalkan lingkungan lokal dalam keadaan apa pun.
+
+**Konfigurasi yang direncanakan:**
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
+        "WHISPER_PRIVACY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+Sampai fitur ini tersedia: jika Anda perlu menganalisis konten transkrip tanpa mengirimkannya ke API Claude, buka file `.txt` langsung di editor teks lokal atau alat pemrosesan.
+
+---
+
+## Panduan Industri yang Diatur
+
+Berikut hanya informasi umum. Penulis alat ini bukan pengacara. Pengguna bertanggung jawab penuh atas kepatuhan terhadap hukum dan peraturan yang berlaku. Jika ragu, konsultasikan dengan penasihat hukum yang berkualifikasi sebelum mentranskrip konten yang diatur.
+
+### HIPAA (AS — layanan kesehatan)
+Penyedia layanan kesehatan, perusahaan asuransi, dan mitra bisnis mereka dilarang mengirimkan Informasi Kesehatan Terlindungi (PHI) kepada pihak ketiga yang tidak berwenang tanpa Perjanjian Mitra Bisnis (BAA). Anthropic tidak menawarkan HIPAA BAA untuk penggunaan API konsumen Claude.
+
+**Kasus penggunaan yang terpengaruh:** Konsultasi pasien, catatan klinis, sesi terapi, panggilan klaim asuransi, rekaman administratif rumah sakit.
+
+**Rekomendasi saat ini:** Jangan mentranskrip audio pasien lalu meminta Claude meringkas atau menganalisis transkrip kecuali organisasi Anda telah menetapkan pengaturan pemrosesan yang patuh. Gunakan `WHISPER_PRIVACY_MODE` saat tersedia.
+
+### GDPR (EU/EEA)
+Data pribadi penduduk EU tidak dapat ditransfer ke pemroses pihak ketiga tanpa persetujuan eksplisit dan dasar hukum untuk pemrosesan. Teks transkrip yang mengandung nama, lokasi, atau informasi pengidentifikasi apa pun merupakan data pribadi menurut GDPR.
+
+**Kasus penggunaan yang terpengaruh:** Wawancara, rapat, rekaman call center, proses hukum yang melibatkan penduduk EU.
+
+**Rekomendasi saat ini:** Perlu diketahui bahwa mengunggah transkrip yang mengandung data pribadi penduduk EU ke Claude mungkin berdampak pada GDPR tergantung pada peran dan tujuan pemrosesan Anda.
+
+### Hak Istimewa Pengacara-Klien (AS, Inggris, Australia, dan sebagian besar yurisdiksi hukum umum)
+Komunikasi antara pengacara dan klien secara hukum memiliki hak istimewa. Pengungkapan kepada pihak ketiga yang tidak berwenang dapat menghilangkan hak istimewa. Tidak ada preseden hukum yang mapan yang melindungi komunikasi pengacara-klien saat diproses oleh API AI komersial.
+
+**Kasus penggunaan yang terpengaruh:** Deposisi hukum, konsultasi klien, rekaman strategi internal, wawancara saksi.
+
+**Rekomendasi saat ini:** Pengacara yang mentranskrip komunikasi yang memiliki hak istimewa tidak boleh mengunggah transkrip tersebut ke Claude untuk analisis tanpa tinjauan hukum independen mengenai implikasi hak istimewa.
+
+### FERPA (AS — pendidikan)
+Catatan pendidikan siswa dilindungi. Sekolah dan universitas tidak dapat mengungkapkan informasi siswa yang dapat diidentifikasi kepada pihak ketiga tanpa persetujuan.
+
+**Kasus penggunaan yang terpengaruh:** Kuliah yang direkam, sesi konseling siswa, sidang akademik, rapat IEP.
+
+### SOX (AS — perusahaan publik)
+Komunikasi keuangan perusahaan publik tunduk pada persyaratan penyimpanan catatan dan kerahasiaan. Informasi non-publik material (MNPI) tidak dapat diungkapkan secara selektif.
+
+**Kasus penggunaan yang terpengaruh:** Rekaman earnings call, transkrip rapat dewan, komunikasi investor, diskusi strategi keuangan internal.
+
+### PCI-DSS
+Data kartu pembayaran tidak dapat disimpan atau dikirim di lingkungan yang tidak aman. Rekaman suara nomor kartu selama transaksi termasuk dalam cakupan.
+
+**Kasus penggunaan yang terpengaruh:** Rekaman call center, panggilan layanan pelanggan yang melibatkan pemrosesan pembayaran.
+
+### Perlindungan Rahasia Dagang / NDA
+Informasi bisnis rahasia, formula eksklusif, detail produk yang belum dirilis, dan informasi personalia mungkin dilindungi oleh kontrak atau hukum.
+
+**Kasus penggunaan yang terpengaruh:** Rapat strategi perusahaan, diskusi R&D, panggilan due diligence M&A, proses HR.
+
+---
+
+## Mengunggah File Transkrip Langsung ke Claude
+
+Saat Anda mengunggah file `.txt` transkrip langsung ke Claude sebagai lampiran file — sepenuhnya di luar alat MCP — server MCP tidak memiliki visibilitas dan tidak dapat menerapkan kontrol privasi apa pun.
+
+Mengunggah transkrip langsung ke Claude setara dengan mengirim konten audio ke Anthropic. Tidak ada mode privasi atau perlindungan tingkat MCP di masa mendatang yang akan berlaku untuk unggahan file langsung.
+
+Pengguna yang menangani konten yang diatur tidak boleh mengunggah transkrip langsung ke Claude. Satu-satunya jalur analisis yang aman untuk konten yang diatur adalah alat pemrosesan lokal yang tidak mengirimkan konten secara eksternal.
+
+---
+
+## Melaporkan Masalah Privasi
+
+Jika Anda mengidentifikasi masalah privasi atau celah arsitektur yang tidak tercakup di sini, gunakan pelaporan kerentanan pribadi GitHub daripada membuka issue publik. Lihat [SECURITY.md](SECURITY.md) untuk instruksi pelaporan.

package/PRIVACY.ja.md

@@ -0,0 +1,135 @@
+# プライバシーアーキテクチャ — whisper-windows-mcp
+
+このドキュメントでは、どのデータがマシンに留まり、どのデータがマシンの外に出るか、そして規制対象または機密性の高いコンテンツに対してツールをどのように設定するかを説明します。
+
+---
+
+## コアな保証
+
+whisper-windows-mcpはローカルファーストのアーキテクチャに基づいて構築されています。**音声・動画ファイルはマシンの外に出ることは一切ありません。** 文字起こしはwhisper.cppを使用してすべてローカルハードウェア上で実行されます — 文字起こし自体にクラウドサービス、インターネット接続、APIコールは不要です。
+
+この保証はメディアファイルに対して無条件に適用されます。
+
+---
+
+## 常にローカルに留まるデータ
+
+| データ | マシンの外に出るか |
+|---|---|
+| 音声ファイル | ❌ 出ない |
+| 動画ファイル | ❌ 出ない |
+| Whisperモデルファイル | ❌ 出ない |
+| 一時WAV変換ファイル | ❌ 出ない（文字起こし後に削除） |
+| バッチ状態・ジョブファイル | ❌ 出ない |
+| ディスク上のトランスクリプト`.txt` / `.srt`ファイル | ❌ 出ない |
+
+---
+
+## デフォルトの動作でマシンの外に出る可能性があるデータ
+
+ツールレスポンスにトランスクリプトテキストが含まれる場合、そのテキストはClaude Desktopに返され、AnthropicのAPIで処理されます。これは標準的なMCPの動作です — テキストはローカルMCPサーバーからClaudeのモデルへネットワークを通じて送信されます。
+
+| データ | マシンの外に出るか |
+|---|---|
+| ツールレスポンスで返されるトランスクリプトテキスト | ✅ デフォルトで出る |
+| Claudeにファイルとして直接アップロードされるトランスクリプト | ✅ 出る（MCPの外側） |
+
+このギャップは、ツールの「データはマシンの外に出ない」という保証とトランスクリプトの分析や要約をClaudeに依頼した際の実際のデータフローの間に存在します。YouTubeの動画、ポッドキャスト、ストリーミング録画などの公開コンテンツを文字起こしするほとんどのユーザーには、この区別は影響しません。
+
+プライベート、機密性の高い、または規制対象の録音を扱うユーザーにとっては、この区別が重要です。
+
+---
+
+## プライバシーモード（計画中 — 未実装）
+
+将来のリリースで`WHISPER_PRIVACY_MODE`環境変数が計画されています。有効化時：
+
+- すべてのツールレスポンスはメタデータのみを返します：ファイル名、時間、単語数、完了状態
+- どのツールレスポンスにもトランスクリプトテキストは含まれません
+- Claudeはトランスクリプトの内容を読み取り、分析、または中継できません
+- トランスクリプトはディスク上のローカル`.txt`ファイルとしてのみ存在します
+
+このモードは医療、法律、金融、および企業向けデプロイメントで、トランスクリプトコンテンツをいかなる状況でもローカル環境の外に出さないことが必要な場合に設計されています。
+
+**計画中の設定：**
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
+        "WHISPER_PRIVACY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+この機能がリリースされるまでの対応：Claudeのターンを通じて送信せずにトランスクリプトコンテンツを分析する必要がある場合は、`.txt`ファイルをローカルのテキストエディターや処理ツールで直接開いてください。
+
+---
+
+## 規制産業向けガイダンス
+
+以下は一般的な情報のみです。このツールの作者は法律の専門家ではありません。ユーザーは適用される法律・規制へのコンプライアンスに対して単独で責任を負います。規制対象コンテンツを文字起こしする前に、不明な点がある場合は資格を持った法律の専門家にご相談ください。
+
+### HIPAA（米国 — 医療）
+医療提供者、保険会社、およびそれらのビジネスアソシエイトは、業務提携契約（BAA）なしに保護対象保健情報（PHI）を無許可の第三者に送信することを禁止されています。AnthropicはClaudeの消費者向けAPI利用に対してHIPAA BAAを提供していません。
+
+**対象となるユースケース：** 患者の相談、臨床メモ、セラピーセッション、保険請求の電話、病院の管理録音。
+
+**現在の推奨事項：** 患者の音声を文字起こしし、そのトランスクリプトをClaudeで要約または分析することは、組織が準拠した処理体制を確立していない限り避けてください。`WHISPER_PRIVACY_MODE`が利用可能になったら使用してください。
+
+### GDPR（EU/EEA）
+EU居住者の個人データは、明示的な同意と適法な処理根拠なしに第三者処理者に転送できません。名前、場所、または識別情報を含むトランスクリプトテキストはGDPRの下で個人データに該当します。
+
+**対象となるユースケース：** インタビュー、会議、コールセンターの録音、EU居住者が関与する法的手続き。
+
+**現在の推奨事項：** EU居住者の個人データを含むトランスクリプトをClaudeにアップロードすることは、あなたの役割と処理目的によってはGDPRへの影響がある可能性があることに注意してください。
+
+### 弁護士・依頼者特権（米国、英国、オーストラリア、およびほとんどのコモンロー法域）
+弁護士と依頼者の間のコミュニケーションは法的に特権が与えられています。無許可の第三者への開示は特権を放棄する可能性があります。商業的なAI APIで処理された場合に弁護士・依頼者のコミュニケーションを保護する確立された法的先例は存在しません。
+
+**対象となるユースケース：** 法的陳述、依頼者との相談、内部戦略の録音、証人インタビュー。
+
+**現在の推奨事項：** 特権的なコミュニケーションを文字起こしする弁護士は、特権への影響について独立した法的レビューなしに、それらのトランスクリプトをClaudeによる分析のためにアップロードすべきではありません。
+
+### FERPA（米国 — 教育）
+生徒の教育記録は保護されています。学校と大学は同意なしに識別可能な生徒情報を第三者に開示できません。
+
+**対象となるユースケース：** 録音された講義、学生カウンセリングセッション、学術的な聴聞会、IEP会議。
+
+### SOX（米国 — 上場企業）
+上場企業の財務コミュニケーションは記録保持と機密性の要件の対象です。重要な未公開情報（MNPI）は選択的に開示できません。
+
+**対象となるユースケース：** 決算発表の録音、取締役会会議のトランスクリプト、投資家とのコミュニケーション、内部財務戦略の議論。
+
+### PCI-DSS
+決済カードデータは安全でない環境で保存または送信できません。取引中のカード番号の音声録音はスコープ内となります。
+
+**対象となるユースケース：** コールセンターの録音、決済処理を含むカスタマーサービスの電話。
+
+### 企業秘密 / NDA保護
+機密ビジネス情報、独自の公式、未発表の製品詳細、および人事情報は契約または法律によって保護される場合があります。
+
+**対象となるユースケース：** 企業戦略会議、R&Dの議論、M&Aのデューデリジェンス通話、HR手続き。
+
+---
+
+## Claudeへのトランスクリプトファイルの直接アップロード
+
+トランスクリプト`.txt`ファイルをClaude Desktopにファイル添付として直接アップロードする場合（MCPツールを介さずに）、MCPサーバーには可視性がなく、プライバシーコントロールを適用できません。
+
+トランスクリプトをClaudeに直接アップロードすることは、音声コンテンツをAnthropicに送信することと同等です。プライバシーモードや将来のMCPレベルの保護は、直接ファイルアップロードには適用されません。
+
+規制対象コンテンツを扱うユーザーはトランスクリプトをClaudeに直接アップロードしてはなりません。規制対象コンテンツの安全な分析パスは、外部にコンテンツを送信しないローカル処理ツールのみです。
+
+---
+
+## プライバシーに関する懸念の報告
+
+ここに記載されていないプライバシー問題またはアーキテクチャのギャップを発見した場合は、公開のIssueを開かずに、GitHubのプライベート脆弱性レポートを使用してください。報告手順については[SECURITY.md](SECURITY.md)を参照してください。