Metadata-Version: 2.4
Name: mcp-server-voicevox
Version: 0.1.0
Summary: A Model Context Protocol server providing VoiceVox text-to-speech functionality for LLMs
Author-email: VoiceVox MCP Developer <example@example.com>
License: MIT
Keywords: llm,mcp,text-to-speech,tts,voicevox
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: requests>=2.31.0
Description-Content-Type: text/markdown

# VoiceVox MCP サーバー

VoiceVox を介してテキスト読み上げ機能を提供する Model Context Protocol サーバーです。このサーバーにより、Claude は VoiceVox エンジンが提供する様々な音声を使用してテキストから音声を生成することができます。

## 前提条件

- VoiceVox エンジンが動作していること（ローカルまたはリモートで）
- Python 3.10 以上

## インストール

### uv の使用（推奨）

[`uv`](https://docs.astral.sh/uv/) を使用する場合は特別なインストールは必要ありません。直接 [`uvx`](https://docs.astral.sh/uv/guides/tools/) を使用して *mcp-server-voicevox* を実行します。

## 設定

### VoiceVox エンジン

このサーバーは動作するために VoiceVox エンジンが必要です。エンジンの起動は手動で行う必要があります。
デフォルトでは `http://localhost:50021` への接続を試みます。`--voicevox-url` 引数で別の URL を指定することができます。

VoiceVox エンジンは [公式 VoiceVox リポジトリ](https://github.com/VOICEVOX/voicevox_engine) からダウンロードしてインストールできます。

### Claude Desktop 用の設定

Claude Desktop の設定に追加：

<details>
<summary>uvx を使用する場合</summary>

```json
"mcpServers": {
  "voicevox": {
    "command": "uvx",
    "args": ["mcp-server-voicevox", "--voicevox-url=http://localhost:50021"]
  }
}
```
</details>

## 利用可能なツール

- `get_voices` - VoiceVox から利用可能な音声のリストを取得
  - 引数は必要ありません

- `text_to_speech` - VoiceVox を使用してテキストを音声に変換
  - 必須引数：
    - `text` (文字列): 音声に変換するテキスト
  - オプション引数：
    - `speaker_id` (整数、デフォルト: 1): 使用する音声の ID
    - `speed` (数値、デフォルト: 1.3): 再生速度の倍率

## 特別な機能

- 生成後の音声は、プラットフォーム固有の方法で自動的に再生されます：
  - Windows: デフォルトのシステムプレーヤーを使用
  - macOS: 内蔵の `afplay` ユーティリティを使用
  - Linux: まず `aplay` を試し、失敗した場合は `xdg-open` にフォールバック


## ライセンス

mcp-server-voicevox は MIT ライセンスの下で提供されています。これは、MIT ライセンスの条件に従い、自由に使用、修正、配布することができることを意味します。