@kajidog/mcp-tts-voicevox 0.7.2 → 0.8.0

package/README.md

@@ -68,7 +68,7 @@ Export behavior by environment:
 
 ### Requirements
 
-- Node.js 18.0.0 or higher (or [Bun](https://bun.sh/)) **or Docker**
+- Node.js 20.0.0 or higher (or [Bun](https://bun.sh/)) **or Docker**
 - [VOICEVOX Engine](https://voicevox.hiroshiba.jp/) (must be running; included in Docker Compose)
 - ffplay (optional, recommended — not needed with Docker)
 
@@ -236,6 +236,8 @@ The main feature callable from Claude.
 | `VOICEVOX_URL` | Engine URL | `http://localhost:50021` |
 | `VOICEVOX_DEFAULT_SPEAKER` | Default speaker ID | `1` |
 | `VOICEVOX_DEFAULT_SPEED_SCALE` | Playback speed | `1.0` |
+| `VOICEVOX_RETRY_COUNT` | Retries for failed API requests (0 disables) | `2` |
+| `VOICEVOX_RETRY_DELAY_MS` | Initial retry delay in ms (exponential backoff) | `250` |
 
 ### Playback Options
 
@@ -259,10 +261,26 @@ Restrict AI from specifying certain options.
 ### Disable Tools
 
 ```bash
-# Disable unnecessary tools
+# Disable individual tools
 export VOICEVOX_DISABLED_TOOLS=speak_player,synthesize_file
+
+# Disable a built-in group of tools
+export VOICEVOX_DISABLED_GROUPS=player
+
+# Combine groups and individual tools
+export VOICEVOX_DISABLED_GROUPS=dictionary
+export VOICEVOX_DISABLED_TOOLS=synthesize_file
 ```
 
+Built-in groups for `VOICEVOX_DISABLED_GROUPS` / `--disable-groups`:
+
+| Group | Tools |
+|-------|-------|
+| `player` | `speak_player`, `resynthesize_player`, `get_player_state`, `open_dictionary_ui` |
+| `dictionary` | `get_accent_phrases`, `get_user_dictionary`, `add_user_dictionary_word`, `update_user_dictionary_word`, `delete_user_dictionary_word`, `add_user_dictionary_words`, `update_user_dictionary_words` |
+| `file` | `synthesize_file` |
+| `apps` | `speak_player`, `resynthesize_player`, `open_dictionary_ui` (MCP App UI tools) |
+
 ### UI Player Settings
 
 | Variable | Description | Default |
@@ -305,14 +323,19 @@ npx @kajidog/mcp-tts-voicevox --http --port 8080
 # With restrictions
 npx @kajidog/mcp-tts-voicevox --restrict-immediate --restrict-wait-for-end
 
-# Disable tools
+# Disable individual tools
 npx @kajidog/mcp-tts-voicevox --disable-tools speak_player,synthesize_file
+
+# Disable a tool group
+npx @kajidog/mcp-tts-voicevox --disable-groups player
 ```
 
 | Argument | Description |
 |----------|-------------|
 | `--help`, `-h` | Show help |
 | `--version`, `-v` | Show version |
+| `--init` | Generate `.voicevoxrc.json` with default settings |
+| `--config <path>` | Path to config file |
 | `--url <value>` | VOICEVOX Engine URL |
 | `--speaker <value>` | Default speaker ID |
 | `--speed <value>` | Playback speed |
@@ -323,7 +346,8 @@ npx @kajidog/mcp-tts-voicevox --disable-tools speak_player,synthesize_file
 | `--restrict-immediate` | Restrict immediate |
 | `--restrict-wait-for-start` | Restrict waitForStart |
 | `--restrict-wait-for-end` | Restrict waitForEnd |
-| `--disable-tools <tools>` | Disable tools |
+| `--disable-tools <tools>` | Disable tools (comma-separated tool names) |
+| `--disable-groups <groups>` | Disable tool groups: `player`, `dictionary`, `file`, `apps` |
 | `--auto-play` / `--no-auto-play` | Auto-play in UI player |
 | `--player-export` / `--no-player-export` | Enable/disable track export(download) in UI player |
 | `--player-export-dir <dir>` | Default output directory for exported tracks |
@@ -341,6 +365,51 @@ npx @kajidog/mcp-tts-voicevox --disable-tools speak_player,synthesize_file
 
 </details>
 
+<details>
+<summary><b>Config File (.voicevoxrc.json)</b></summary>
+
+You can use a JSON config file instead of (or in addition to) environment variables and CLI arguments. This is useful when you have many settings to configure.
+
+**Priority order:** CLI args > Environment variables > Config file > Defaults
+
+### Generate a config file
+
+```bash
+npx @kajidog/mcp-tts-voicevox --init
+```
+
+This creates `.voicevoxrc.json` in the current directory with all default settings. Edit it as needed.
+
+### Use a custom config file path
+
+```bash
+npx @kajidog/mcp-tts-voicevox --config ./my-config.json
+```
+
+Or via environment variable:
+
+```bash
+VOICEVOX_CONFIG=./my-config.json npx @kajidog/mcp-tts-voicevox
+```
+
+### Example `.voicevoxrc.json`
+
+```json
+{
+  "url": "http://192.168.1.50:50021",
+  "speaker": 3,
+  "speed": 1.2,
+  "http": true,
+  "port": 8080,
+  "disable-tools": ["synthesize_file"],
+  "disable-groups": ["dictionary"]
+}
+```
+
+Keys can be written in kebab-case (`use-streaming`), camelCase (`useStreaming`), or internal key names (`defaultSpeaker`). If `.voicevoxrc.json` exists in the current directory, it is loaded automatically.
+
+</details>
+
 <details>
 <summary><b>HTTP Mode</b></summary>