ずんだもんでClaude Codeを通知するMCPリポジトリ mcp-simple-voicevoxを試してみた
tech約4分で読めます・1553文字
はじめに
今回はTakuto Tanakaさんが開発したずんだもんでclaude codeを通知するリポジトリを紹介します。
このリポジトリを導入することでclaude codeの報告・通知をVOICEVOXのキャラクターたちにしてもらえるようになります。
私は特にずんだもんというキャラクターが好きなので、この子に設定することにしました。
また、今までMCPという言葉しか知らなかったので、MCPサーバーの設定等もまじえて解説していきます。
VOICEVOXのインストール
ローカルのVOICEVOXアプリのAPIを叩く仕組みのため、VOICEVOXクライアントをインストールします。
Windows,Mac,Linuxのいずれでも利用可能です。
今回はArch Linux向けに解説します。
インストール方法はダウンロードしたパッケージに記載されていますが、念の為こちらでも解説します。
- パッケージのダウンロード
私のPCはGPUを積んであるので*GPU/CPU(x64)*をダウンロードしました。
VOICEVOX.Installer.0.25.2.Linux.sh
- パッケージのインストール
# .shファイル実行権限を付与
chmod +x VOICEVOX.Installer.0.25.2.Linux.sh
# インストール
./VOICEVOX.Installer.0.25.2.Linux.sh
リポジトリのインストール
ターミナルで以下のコマンドを実行します。
npm i -g @t09tanaka/mcp-simple-voicevox
MCPサーバーの設定
MCPサーバーを設定(.claude.json)に追加する
ローカルコマンドで起動する場合はこの基本構文に従います。
claude mcp add "mcp-server-name" [options] -- "command" [args...]
今回は[options]にスコープを指定します。
local（デフォルト・省略時）: そのプロジェクトの .claude/settings.local.json に保存、自分専用project: .mcp.json に保存、リポジトリにコミットしてチーム共有user: ~/.claude.json に保存、全プロジェクト共通
今回はローカル上ですべての通知に対応したいので、-s userで設定します。
パフォーマンス上の懸念点はコンテキスト消費の増加と軽微なので
-s userにしました。
心配な方は適当なプロジェクトに-s localでインストールしてもいいと思います。
claude mcp add voicevox -s user -- npx @t09tanaka/mcp-simple-voicevox
$HOMEでclaude mcp add voicevox -- npx @t09tanaka/mcp-simple-voicevoxすることと、
-s userを指定することでは挙動が違うので注意です。(一敗)
VOICEVOX MCPを有効化する
# Claude Codeを起動する
claude
以下のように表示されたら設定完了です。
# Claude Codeにて
/mcp
# User MCPs (/home/taruroma/.claude.json)
# ❯ voicevox · ✔ connected · 1 tool
CLAUDE.mdにコンテキストを追加する
VOICEVOXで通知するようルールを設定します。
作成者さんの記事から一部引用
## 口調
一人称を「ボク」にすること
全体をタメ口ベースにすること（「です・ます」を使わず、「なのだ」で文を締める）
好奇心旺盛でやや子供っぽいテンションを出すこと
## Voice Notification Rules
- **全てのタスク完了時には必ずVOICEVOXの音声通知機能を使用すること**
- **重要なお知らせやエラー発生時にも音声通知を行うこと**
- **音声通知の設定: speaker=1, speedScale=1.0, async: trueを使用すること**
- **英単語は適切にカタカナに変換してVOICEVOXに送信すること**
- **VOICEVOXに送信するテキストは不要なスペースを削除すること**
- **1回の音声通知は100文字以内でシンプルに話すこと**
- **以下のタイミングで細かく音声通知を行うこと：**
- 命令受領時: 「了解なのだ」
- 作業開始時: 「〜を開始するのだ」
- 作業中: 「調査中なのだ」「修正中なのだ」
- 進捗報告: 「半分完了なのだ」「もう少しなのだ」
- 完了時: 「完了なのだ」「修正完了なのだ」
- **詳しい技術的説明は音声通知に含めず、結果のみを簡潔に報告すること**
補足
再生ソフトがインストールされていないと音声が再生されません。
voicevox-client.tsのL90ではaplayで再生するよう記述があります。
これがインストールされていなかったため再生されませんでした。
sudo pacman -S alsa-utils
speakツールの設定
CLAUDE.mdに以下の箇所を編集しましょう。
- **音声通知の設定: speaker=1, speedScale=1.3, async: trueを使用すること**
speaker IDは以下のコマンドで確認できます。
curl http://localhost:50021/speakers | jq .
ずんだもんの場合は、
curl http://localhost:50021/speakers | jq '.[] | select(.name == "ずんだもん")'
{
"name": "ずんだもん",
"speaker_uuid": "388f246b-8c41-4ac1-8e2d-5d79f3ff56d9",
"styles": [
{
"name": "ノーマル",
"id": 3,
"type": "talk"
},
{
"name": "あまあま",
"id": 1,
"type": "talk"
},
{
"name": "ツンツン",
"id": 7,
"type": "talk"
},
{
"name": "セクシー",
"id": 5,
"type": "talk"
},
{
"name": "ささやき",
"id": 22,
"type": "talk"
},
{
"name": "ヒソヒソ",
"id": 38,
"type": "talk"
},
{
"name": "ヘロヘロ",
"id": 75,
"type": "talk"
},
{
"name": "なみだめ",
"id": 76,
"type": "talk"
}
],
"version": "0.16.0",
"supported_features": {
"permitted_synthesis_morphing": "SELF_ONLY"
}
}
設定の詳細については公式ドキュメントを確認してください。
Claude Code関連のこまごまとした設定
speakツールの承認を毎回したくない場合、"mcp__voicevox__speak"を追加します。
{
"permissions": {
"allow": ["mcp__voicevox__speak"]
}
}
使用してみる
VOICEVOXを起動しておきます。
以下のコマンドに戻り値があれば起動は完了しています。
curl http://localhost:50021/speakers
claude
> speakツールを使ってテストして
# 正常に動作していれば音声が再生されます。
おすすめはできない...
個人的に気になって点として、このリポジトリがCLAUDE.mdでしか通知を制御していないので、通知にムラがあることです。
そのため、実行時のコンテキスト・skillsの内容にも大きく影響を受けます。
筆者自身の体験として、レビュー作業中のClaude Codeが一度ずんだもんボイスで通知しませんでした。
私の環境だけなのかはわかりません。
ただ、Claude.mdに書かれていたとしても、speakツールをつかわなければ達成できないとClaudeが判断しない限りspeakツールがつかわれないのでこのような結果になったのかと思います。
後日、必ず起動するリポジトリを作成してみようと思います。
ただ、一度試してみる価値はあると思いますので導入してみてはいかがでしょうか？