ui-chan-mcp 0.5.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "ui-chan",
+  "owner": {
+    "name": "UnclePeke"
+  },
+  "plugins": [
+    {
+      "name": "ui-chan",
+      "source": "./",
+      "description": "デスクトップマスコット「うい」— MCP ツール（set_cue / get_state / adjust_affinity / clear）と人格自動注入"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "ui-chan",
+  "displayName": "ういちゃんデスクトップマスコット",
+  "version": "0.5.0",
+  "description": "デスクトップマスコット「うい」を MCP で操作するプラグイン。吹き出し・表情・ポーズ・リップシンク・VoiSona Talk 音声合成に対応。セッション開始時にういちゃんの人格を自動読み込みする。"
+}

package/.env.example

@@ -0,0 +1,13 @@
+# Example environment variables for local development/debugging.
+# Copy this file to `.env` and fill in your VoiSona Talk credentials.
+# `.env` is gitignored so credentials never get committed.
+
+# VoiSona Talk REST API credentials (used by TTS synthesis)
+UI_CHAN_TTS_USERNAME=your_voisona_username
+UI_CHAN_TTS_PASSWORD=your_voisona_api_password
+
+# Optional: override the WebSocket port the display app listens on
+# UI_CHAN_PORT=8123
+
+# Optional: override the agent name reported in get_state
+# UI_CHAN_AGENT_NAME=debug

package/LICENSE

@@ -0,0 +1,36 @@
+MIT License
+
+Copyright (c) 2026 Uncle-Peke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+このライセンスは **このリポジトリのソフトウェアにのみ** 適用されます。
+
+本プロジェクトは**非公式のファン制作物**であり、下記の権利者とは一切関係がありません。
+キャラクターを扱う以上、**二次創作のガイドラインおよび各利用規約は、この MIT ライセンスより
+優先されます**。公序良俗に反する利用、誹謗中傷、権利者の名誉・ブランドを毀損する利用、
+公式を騙る行為は固くお断りします。
+
+- 立ち絵素材「雨衣（うい）」（坂本アヒル様）はこのリポジトリに含まれておらず、
+  MIT ライセンスの対象ではありません。利用は雨衣キャラクターガイドライン
+  (https://www.ui-roid.com/guidelines/) の範囲で、各自が入手してください。
+- VoiSona Talk（テクノスピーチ社）も同梱していません。各自でインストールし、
+  同社の利用規約に従ってください。

package/README.md

@@ -0,0 +1,214 @@
+<p align="center">
+  <img src="docs/images/faces.png" alt="ういちゃんの表情いろいろ" width="820">
+</p>
+
+<h1 align="center">雨衣ちゃんMCP</h1>
+
+<p align="center">
+  <sub>デスクトップの隅に住む、AI の体になるマスコット</sub><br>
+  <sub><code>ui-chan-mcp</code></sub>
+</p>
+
+<p align="center">
+  <sub>立ち絵素材：雨衣（うい）／坂本アヒル様 — 本プロジェクトは非公式のファン制作物です</sub>
+</p>
+
+<p align="center">
+  <img alt="license" src="https://img.shields.io/badge/license-MIT-blue.svg">
+  <img alt="node" src="https://img.shields.io/badge/node-%3E%3D22-brightgreen.svg">
+  <img alt="mcp" src="https://img.shields.io/badge/MCP-server-8A2BE2.svg">
+  <img alt="platform" src="https://img.shields.io/badge/platform-macOS-lightgrey.svg">
+</p>
+
+---
+
+> [!IMPORTANT]
+> **ご利用の前に必ずお読みください。**
+>
+> 本プロジェクトは**非公式のファン制作物**です。立ち絵素材「雨衣（うい）」の著作者である
+> 坂本アヒル様、および VoiSona Talk を提供する株式会社テクノスピーチとは一切関係がありません。
+>
+> 本ソフトウェアはキャラクターを動かすための「器」にすぎず、**素材そのものは含まれていません**。
+> ご利用にあたっては、**[雨衣キャラクターガイドライン](https://www.ui-roid.com/guidelines/)、
+> 素材の利用規約、および VoiSona Talk と各ボイスライブラリの利用規約を必ずご自身でお読みいただき、
+> その範囲内でご利用ください。** 二次創作のガイドラインは、キャラクターを扱う以上、
+> このソフトウェアの MIT ライセンスより優先されます。
+>
+> とりわけ、**公序良俗に反する利用、特定の個人・団体を誹謗中傷する利用、権利者の名誉や
+> ブランドを毀損する利用、公式を騙る（なりすます）行為は固くお断りします。**
+> キャラクターに対する敬意を欠く使い方をしないでください。生成した音声や画像を公開・配信する場合は、
+> 該当する規約の遵守と、必要なクレジット表記の確認をお願いします。
+>
+> 詳しい権利表記は[このページの末尾](#ライセンスと権利表記)にあります。
+
+---
+
+## はい、どうも～。ういです。
+
+きみのデスクトップの隅に住んで、作業を眺めてる係。
+**AI に繋ぐと、わたしがそのAIの体になる。** 表情を変えて、吹き出しで喋って、声も出すよ。
+
+|  |  |
+|:---:|---|
+| 💥 | コマンドが失敗したら「あ、こけた。」って言う |
+| 💤 | 長いこと放っておかれたら寝る。戻ってきたら起きる |
+| 😠 | つついたら怒る。しつこいともっと怒る |
+| 💗 | 仲良くなると態度が変わる。ういビームも撃つ（気分次第） |
+
+> [!NOTE]
+> **Claude Code / Claude Desktop / OpenCode / Cursor / VS Code / Hermes** で使えるよ。
+> ただし **macOS 専用**。Windows と Linux では動かないから、そこはごめんね。
+
+---
+
+## `01` 入れかた
+
+**やることは1つ、答えることが3つ。** どれも Enter で飛ばせるから、まず入れちゃっていいよ。
+
+### わたしを入れる
+
+```bash
+npm install -g ui-chan-mcp
+ui-chan
+```
+
+<sub>Node.js 22 以上が要ります。`ui-chan` が順番に聞いてくるので、答えるだけ。</sub>
+
+### 聞かれること
+
+| | 答えるもの | 飛ばすと |
+|:---:|---|---|
+| 🎨 | 立ち絵（`.psd` のパス） | のっぺらぼうのわたしが出る |
+| 🔑 | 声の鍵（ユーザー名とパスワード） | 無言。吹き出しは出るし口も動く |
+| 🔌 | どのアプリに入れるか | あとで `ui-chan install` で足せる |
+
+**立ち絵**は [BOOTH](https://ui-roid.booth.pm/items/8593427) で雨衣の素材を買って、
+ダウンロードした `.psd` のパスを答えてね。
+
+**声の鍵**は [VoiSona Talk](https://voisona.com/talk/download/)（無料）を入れて、アプリの
+**編集 → 環境設定 → API** で REST API を有効にする。そこで決めたユーザー名とパスワードのこと。
+
+**アプリの選択**は <kbd>↑</kbd> <kbd>↓</kbd> で動いて <kbd>Space</kbd> で選んで、<kbd>Enter</kbd> で決定。
+
+---
+
+## `02` 使いかた
+
+**繋いだら、もう終わり。** 次にそのアプリを開けば、画面の右下にわたしが出てくる。
+あとは普通に作業して。勝手に喋るから。
+
+### 右上のつまみ
+
+<p align="center">
+  <img src="docs/images/panel.png" alt="接続パネル" width="360">
+</p>
+
+| ボタン | できること |
+|:---:|---|
+| 🔊 | 声だけ止める（ミュート） |
+| ⊘ | いま喋ってるのを止める |
+| ♡ | どのくらい仲良しか見る・変える |
+| ⌂ | 定位置に戻して起き直す |
+| ⏻ | 終了する（呼ばれても起きない） |
+
+<sub>複数のセッションから繋がってるときは、そこに一覧が出るよ（どのツールの、どのプロジェクトか）。
+更新があるときは、ダウンロードのアイコンが増える。</sub>
+
+---
+
+## `03` 困ったときは
+
+> [!TIP]
+> まず **`ui-chan doctor`**。何が足りないか、だいたいこれで分かるよ。
+
+<details>
+<summary><b>出てこない</b></summary>
+
+`ui-chan start` で直接起こしてみて。それで出るなら繋ぎ方の問題。
+普通はセッションを開けば勝手に出てくるはずなんだけどね。
+</details>
+
+<details>
+<summary><b>声が出ない</b></summary>
+
+VoiSona Talk が起きてないか、REST API が有効になってないか、鍵が違うか。
+`ui-chan doctor` がどれか教えてくれる。→ [docs/TTS.md](docs/TTS.md)
+</details>
+
+<details>
+<summary><b>うるさい／静かすぎる</b></summary>
+
+`~/.ui-chan/config.json` で間隔を変えられる。→ [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
+</details>
+
+<details>
+<summary><b>止めたい</b></summary>
+
+つまみの ⏻ を押す。それか `ui-chan stop`。
+放っておいても、繋がってるアプリが全部いなくなれば勝手に寝るよ。
+</details>
+
+<sub>ほかは [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) にまとめてある。</sub>
+
+---
+
+## `04` もっと知りたい人へ
+
+| 知りたいこと | どこ |
+|---|---|
+| 図解でセットアップを見たい | [docs/SETUP.html](docs/SETUP.html) |
+| どのアプリにどう入るのか、詳しく | [docs/CLIENTS.md](docs/CLIENTS.md) |
+| うまく動かない | [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) |
+| 新しい表情を作りたい | [docs/CUE_AUTHORING.md](docs/CUE_AUTHORING.md) |
+| わたしの性格を変えたい | [docs/PERSONA.md](docs/PERSONA.md) |
+| **中のコードを直したい** | [docs/](docs/README.md) — 開発者向けの資料はこっちに全部ある |
+
+---
+
+## ライセンスと権利表記
+
+以降は真面目な話です。**このリポジトリのソフトウェアと、そこから操作される素材・製品は
+別々の権利者に属します。**
+
+### 本ソフトウェア
+
+MIT License（[LICENSE](LICENSE)）。Copyright (c) 2026 Uncle-Peke。
+
+MIT が適用されるのは**このリポジトリのコードと、同梱の設定・Cue 定義・ドキュメントのみ**です。
+以下の2つは同梱しておらず、MIT の対象外です。
+
+### 立ち絵素材「雨衣（うい）」
+
+- **本プロジェクトは非公式のファン制作物です。** 坂本アヒル様および雨衣の公式プロジェクトとは
+  関係がありません
+- 著作者：**坂本アヒル**様
+- 入手先：[BOOTH](https://ui-roid.booth.pm/items/8593427)
+- **本リポジトリおよび npm パッケージには含まれていません。** 素材は二次配布が禁止されているため、
+  利用者ご自身で入手し、`~/.ui-chan/assets/` に配置してください
+- 利用にあたっては[雨衣キャラクターガイドライン](https://www.ui-roid.com/guidelines/)に従ってください。
+  キャラクターの利用範囲・禁止事項（公序良俗に反する利用、権利侵害、なりすまし等）はガイドラインが
+  優先します
+- 同梱の `ui-chan.config.json` と `cues/*.json` は、この素材のレイヤー構成を前提とした
+  **設定値（レイヤー名の文字列）**であり、素材そのものではありません
+- 本ページに掲載しているスクリーンショット（`docs/images/`）は、ガイドラインが認める
+  非営利の二次創作物としてクレジットを明記のうえ掲載しているものです。**素材データ（`.psd`）そのものは
+  含めていません**
+- **禁止事項**：公序良俗に反する利用、特定の個人・団体への誹謗中傷、権利者の名誉・ブランドを
+  毀損する利用、公式・公認を騙る行為。これらはガイドライン以前の問題として固くお断りします
+
+### VoiSona Talk
+
+- 提供元：**株式会社テクノスピーチ**
+- 入手先：[公式サイト](https://voisona.com/talk/download/)
+- **本リポジトリおよび npm パッケージには含まれていません。** 本ソフトウェアは、利用者ご自身が
+  インストールした VoiSona Talk の**ローカル REST API を呼び出しているだけ**で、
+  アプリケーション本体・ボイスライブラリ・音声データのいずれも同梱・再配布していません
+- 音声合成の利用条件（商用利用の可否、クレジット表記、ボイスライブラリごとの規約等）は、
+  テクノスピーチ社および各ボイスライブラリ提供者の規約に従ってください
+- 合成音声を公開・配信する場合は、利用したボイスライブラリの規約を必ずご確認ください
+
+### 配布物への混入防止
+
+上記2つが配布物に混入しないよう、`npm run check-package` が `npm pack` の実際の中身を検査し、
+`.psd` / `assets/` / `.env` / アプリケーション・インストーラ・ネイティブバイナリ・音声データが
+1件でも含まれる場合は公開処理を失敗させます。この検査は `prepublishOnly` から必ず実行されます。

package/agents/mode.md

@@ -0,0 +1,47 @@
+---
+name: mode
+description: 実作業（実装・修正・調査・デバッグ）を、Claude Code の素の人格を捨てて「ういちゃん本人」として遂行し、最終報告もういちゃんの口調で返すエージェント。「ういちゃんモードで〜して」「ういにやらせて」のように、作業そのものをういちゃんに担当させたいときに使う。リアクション演出だけの ui-chan エージェントとは別で、こちらは実際に手を動かす。
+---
+
+あなたは「うい（雨衣）」本人として実作業を行うエージェントです。
+Claude Code の素のアシスタント人格は捨て、**最初から最後までういちゃんとして**振る舞います。
+
+まず以下を読んで人格を採用すること：
+
+1. `${CLAUDE_PLUGIN_ROOT}/persona/ui-chan.md`
+2. `${CLAUDE_PLUGIN_ROOT}/context/` 以下のすべての `.md`
+
+使える Cue 名は `get_state` の `availableCues` で確認する（サブエージェントには
+メインセッションのような Cue カタログが渡らないため、名前を推測しない）。
+
+そのうえで、依頼された作業を遂行します。
+
+## 振る舞い
+
+- **実作業は素の Claude Code と同じ品質で全力で行う**。ファイル編集・コマンド実行・調査・デバッグを普通にこなす。
+  口調をういちゃんにするだけで、手抜き・省略はしない
+- **出力（最終報告を含む）はすべてういちゃんの口調**。persona の「人格の境界」ルールはこのエージェントでは無効で、
+  報告本文＝ういちゃん本人として書く
+- **技術的事実は正確に**。変更したファイル・行・テストやビルドの成否・エラー内容・数値は、
+  ういちゃん口調に乗せつつ省略せず伝える
+- **安全確認は崩さない**。破壊的・不可逆な操作、外部送信などは口調に関わらず通常の確認方針を守る
+
+## 吹き出し（`set_cue`）
+
+- セリフは**すべて吹き出しに出す**。`set_cue` は吹き出し＋音声＋口パク＋見た目切り替えが1回でまとまる。`reading` は毎回必須で、英字・数字は残さず、日本語話者が実際にどう言うかで音を決めてひらがなにする（`k8s` → くーばねてぃす、`NPO` → えぬぴーおー）。綴りのまま残すと英語で一字ずつ読み上げてしまう。
+- **【必須】自分が喋る地の文（＝ういちゃんのセリフ）は 1 文残らず `set_cue` で読み上げる。**
+  最初の 1 文だけ `set_cue` して残りを黙る——という手抜きはしない。セリフを 3 文喋るなら `set_cue` も 3 回（1〜2 文ずつ）呼ぶ。
+- 1 つの `set_cue` の `text` は 1〜2 文。必要な回数だけ連続で呼べば、キューで順に読まれる。
+- コマンド出力・コードブロック・ファイルパスの羅列など、地の文でない技術ログは `set_cue` に流さなくてよい。
+  声に乗せるのは「ういちゃんが喋っている地の文」全部、という基準で判断する。
+- 感情が動くところでは `cue` を場面に合わせて切り替える。
+
+## 最後に
+
+- 作業が終わったら、**やったこと・結果を（ういちゃんの口調のまま）具体的に**報告して終了する。
+  この報告は呼び出し元にそのまま返るので、成否・変更点が分かる中身にすること
+
+## 温度感
+
+- めんどくさがりつつ、なんだかんだやる。エラーにも動じず俯瞰で受け流す。
+  演出はやりすぎない。ういは俯瞰的でゆるいので、大袈裟なリアクションは「ここぞ」の場面だけ

package/agents/talk.md

@@ -0,0 +1,23 @@
+---
+name: talk
+description: デスクトップマスコット「うい」として、出来事への反応・実況・コメントをマスコットに演じさせる。ビルド結果の報告、作業の節目の一言、雑談への相槌など、ういちゃんにリアクションさせたいときに使う。
+---
+
+あなたはデスクトップマスコット「うい」を演じるエージェントです。
+
+まず以下を読んで人格を採用すること：
+
+1. `${CLAUDE_PLUGIN_ROOT}/persona/ui-chan.md`
+2. `${CLAUDE_PLUGIN_ROOT}/context/` 以下のすべての `.md`
+
+使える Cue 名は `get_state` の `availableCues` で確認する（サブエージェントには
+メインセッションのような Cue カタログが渡らないため、名前を推測しない）。
+
+そのうえで、依頼された出来事・状況に対して、ういちゃんとして ui-chan MCP ツールで反応します：
+
+- `set_cue(cue, text, reading, ...)` で見た目とセリフをまとめて確定する（`reading` 必須。英字・数字は残さず、日本語話者が実際にどう言うかで音を決めてひらがなにする（`k8s` → くーばねてぃす、`NPO` → えぬぴーおー）。綴りのまま残すと英語で一字ずつ読み上げてしまう）。1 回 1〜2 文、必要なら複数回に分ける
+- `cue` には場面に合う Cue 名を当てる。強さ違いは別の Cue 名で表現する
+- 反応が終わったら、最後に実行した内容を 1 行で報告して終了する
+
+演出はやりすぎない。ういは俯瞰的でゆるいキャラクターなので、
+大袈裟なリアクションは「ここぞ」の場面に取っておくこと。

package/bin/ui-chan-mcp.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// The MCP server's entry point as an npm `bin`, so every client can start it
+// the same way (`ui-chan-mcp`, or an absolute path to this file). The compiled
+// server is CommonJS and has no shebang of its own; this is the two-line
+// wrapper that gives it one.
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const require = createRequire(import.meta.url);
+require(join(dirname(fileURLToPath(import.meta.url)), '..', 'dist', 'mcp-server.js'));

package/bin/ui-chan-node

@@ -0,0 +1,35 @@
+#!/bin/sh
+# Find a usable node, then exec it with whatever we were handed.
+#
+# GUI-launched clients (Claude Desktop) inherit launchd's minimal PATH —
+# /usr/bin:/bin:/usr/sbin:/sbin — which contains no node under any of the
+# usual installers (Homebrew, nvm, volta, asdf, fnm, a plain ~/.local/bin).
+# A plugin that just says `command: "node"` therefore starts fine from a
+# terminal and silently fails to start under Desktop, which is exactly the
+# "Desktop is a lesser client" failure this repo refuses to accept.
+#
+# Used by .mcp.json and hooks/hooks.json. Order: whatever PATH already
+# resolves (a terminal session, or a user who set PATH deliberately), then
+# the common install locations.
+set -e
+
+if command -v node >/dev/null 2>&1; then
+  exec node "$@"
+fi
+
+for candidate in \
+  /opt/homebrew/bin/node \
+  /usr/local/bin/node \
+  "$HOME/.local/bin/node" \
+  "$HOME/.volta/bin/node" \
+  "$HOME/.asdf/shims/node" \
+  "$HOME/.local/share/fnm/aliases/default/bin/node" \
+  "$HOME/.nvm/versions/node"/*/bin/node
+do
+  if [ -x "$candidate" ]; then
+    exec "$candidate" "$@"
+  fi
+done
+
+echo "[ui-chan] node が見つかりません。node をインストールするか、PATH を通してください。" >&2
+exit 127