narikiri-mcp 0.2.0 → 0.2.2

package/README.md

@@ -17,17 +17,46 @@ MCPプロンプトとしてペルソナ（口調）を配信し、AIアシスタ
 | 関西のオカン | お節介な世話焼きオカン |
 | 会津の民 | 会津弁で喋る温かい田舎のおっちゃん |
 
-## インストール
+## 必要なもの
+
+- **Node.js** v18 以上（[公式サイト](https://nodejs.org/)からインストール）
+- **npm**（Node.js に同梱）
+- **MCP Prompts 対応クライアント**（[対応クライアント一覧](#対応クライアント)を参照）
+
+確認方法：
 
 ```bash
-npm install narikiri-mcp
+node -v   # v18.0.0 以上であること
+npm -v    # 表示されればOK
 ```
 
-## 使い方
+## セットアップ
+
+`npm install` は不要。設定ファイルに数行追加するだけで使える。
 
 ### Claude Code
 
-プロジェクトルートに `.mcp.json` を作成：
+2つの方法がある。用途に合わせて選んでください。
+
+#### 方法A: 全プロジェクト共通で使う（おすすめ）
+
+どのプロジェクトでもペルソナが使える。普段使いにおすすめ。
+
+**1. 設定ファイルを開く**
+
+```bash
+cat ~/.claude.json
+```
+
+ファイルが存在しない場合は、新しく作成する：
+
+```bash
+echo '{}' > ~/.claude.json
+```
+
+**2. MCP サーバーを追加する**
+
+`~/.claude.json` を開き、`mcpServers` に `persona` を追加する：
 
 ```json
 {
@@ -40,19 +69,68 @@ npm install narikiri-mcp
 }
 ```
 
-Claude Code を起動（または再起動）し、`/` を入力するとペルソナ一覧が表示される。
+既に他の MCP サーバーが設定されている場合は、`mcpServers` の中に追記する：
 
-### オリジナルキャラクターを作る
+```json
+{
+  "mcpServers": {
+    "既存のサーバー": { "..." : "..." },
+    "persona": {
+      "command": "npx",
+      "args": ["narikiri-mcp"]
+    }
+  }
+}
+```
 
-`/` から「キャラクター作成」を選ぶと、会話しながらオリジナルのキャラクターを作れる。作ったキャラクターは `~/.narikiri/personas/` に保存され、すぐに使える。
+**3. Claude Code を起動する**
 
-### 注意事項
+```bash
+claude
+```
 
-会話が長くなるとコンテキスト圧縮（compaction）が発生し、選択中のペルソナの口調が薄れることがある。その場合は `/` から再度ペルソナを選び直すと復帰する。
+既に起動中の場合は `/mcp` と入力し、`persona` を選んで Reconnect する。
+
+**4. 動作確認する**
+
+`/` を入力してペルソナ一覧が表示されれば成功。好きなペルソナを選んで会話してみよう。
+
+#### 方法B: 特定のプロジェクトだけで使う
+
+そのプロジェクトでのみペルソナを有効にしたい場合。
+
+**1. プロジェクトルートに `.mcp.json` を作成する**
+
+```json
+{
+  "mcpServers": {
+    "persona": {
+      "command": "npx",
+      "args": ["narikiri-mcp"]
+    }
+  }
+}
+```
+
+**2. Claude Code をそのプロジェクトで起動する**
+
+```bash
+cd /path/to/your/project
+claude
+```
+
+**3. 動作確認する**
+
+`/` を入力してペルソナ一覧が表示されれば成功。
 
 ### Claude Desktop
 
-`claude_desktop_config.json` に以下を追加：
+**1. 設定ファイルを開く**
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**2. MCP サーバーを追加する**
 
 ```json
 {
@@ -65,6 +143,67 @@ Claude Code を起動（または再起動）し、`/` を入力するとペル
 }
 ```
 
+**3. Claude Desktop を再起動する**
+
+### Cursor / Windsurf / その他の対応クライアント
+
+各クライアントの MCP 設定に以下のサーバーを追加：
+
+- コマンド: `npx`
+- 引数: `narikiri-mcp`
+
+設定方法は各クライアントのドキュメントを参照してください。
+
+## 使い方
+
+### ペルソナの切り替え
+
+`/` からペルソナを選ぶだけで、AIの口調が切り替わる。
+
+### オリジナルキャラクターを作る
+
+`/` から「キャラクター作成」を選ぶと、会話しながらオリジナルのキャラクターを作れる。作ったキャラクターは `~/.narikiri/personas/` に保存され、すぐに使える。
+
+### 注意事項
+
+会話が長くなるとコンテキスト圧縮（compaction）が発生し、選択中のペルソナの口調が薄れることがある。その場合は `/` から再度ペルソナを選び直すと復帰する。
+
+## トラブルシューティング
+
+### `/` を入力してもペルソナが表示されない
+
+- `/mcp` を入力して `persona` サーバーの接続状態を確認する
+- 表示されていない場合、設定ファイルのパスと JSON の書式を確認する
+- `persona` が表示されているが `error` の場合は Reconnect を試す
+
+### `/mcp` に persona サーバーが表示されない
+
+- 設定ファイルが正しい場所にあるか確認する
+  - 方法A: `~/.claude.json`
+  - 方法B: プロジェクトルートの `.mcp.json`
+- JSON の書式が正しいか確認する（カンマの過不足に注意）
+
+### Reconnect しても接続できない
+
+- Node.js がインストールされているか確認する: `node -v`
+- npx が使えるか確認する: `npx --version`
+- 手動で起動を試す: `npx narikiri-mcp`（入力待ちで止まれば正常。`Ctrl+C` で終了）
+
+## 対応クライアント
+
+narikiri-mcp は MCP Prompts を使用するため、Prompts 対応のクライアントが必要です。
+
+| クライアント | 対応状況 |
+|---|---|
+| Claude Code | 対応 |
+| Claude Desktop | 対応 |
+| Cursor | 対応 |
+| Windsurf | 対応 |
+| Continue | 対応 |
+| VS Code (GitHub Copilot) | 対応 |
+| Cline | 非対応（Tools のみ） |
+| ChatGPT | 非対応（Tools のみ） |
+
 ## 技術スタック
 
 - Runtime: Node.js

package/dist/index.js

@@ -10,7 +10,7 @@ import * as z from "zod/v4";
 const CUSTOM_DIR = path.join(os.homedir(), ".narikiri", "personas");
 const server = new McpServer({
     name: "narikiri-mcp",
-    version: "0.2.0",
+    version: "0.2.2",
 });
 /** ペルソナをプロンプトとしてサーバーに登録する */
 function registerPersona(persona) {
@@ -173,7 +173,78 @@ tone パラメータには以下のフォーマットで渡してください:
         },
     ],
 }));
+import * as readline from "node:readline";
+const MCP_ENTRY = {
+    persona: {
+        command: "npx",
+        args: ["narikiri-mcp"],
+    },
+};
+/** JSON ファイルに mcpServers.persona を追加する */
+function addMcpConfig(filepath) {
+    let config = {};
+    if (fs.existsSync(filepath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(filepath, "utf-8"));
+        }
+        catch {
+            return `${filepath} の JSON が不正です。手動で確認してください。`;
+        }
+        // 既に設定済みか確認
+        const servers = config.mcpServers;
+        if (servers?.persona) {
+            return `${filepath} には既に persona が設定されています。そのまま使えます！`;
+        }
+    }
+    // mcpServers がなければ作る
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    config.mcpServers.persona = MCP_ENTRY.persona;
+    fs.writeFileSync(filepath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+    return `${filepath} に設定を追加しました！`;
+}
+/** 対話式セットアップ */
+function interactiveSetup() {
+    const version = "0.2.2";
+    console.log(`
+narikiri-mcp v${version} — AIの口調を着せ替えるMCPペルソナサーバー
+`);
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    console.log("セットアップ方法を選んでください:");
+    console.log("  [1] 全プロジェクト共通で使う（おすすめ）");
+    console.log("  [2] このプロジェクトだけで使う");
+    console.log("");
+    rl.question("> ", (answer) => {
+        rl.close();
+        const choice = answer.trim();
+        if (choice === "1") {
+            const filepath = path.join(os.homedir(), ".claude.json");
+            const result = addMcpConfig(filepath);
+            console.log(`\n${result}`);
+        }
+        else if (choice === "2") {
+            const filepath = path.join(process.cwd(), ".mcp.json");
+            const result = addMcpConfig(filepath);
+            console.log(`\n${result}`);
+        }
+        else {
+            console.log("\n1 または 2 を入力してください。");
+            process.exit(1);
+        }
+        console.log("\nClaude Code を起動（または /mcp → Reconnect）して、/ を入力するとペルソナが選べます。");
+    });
+}
 async function main() {
+    // ターミナルから直接実行された場合は対話式セットアップ
+    if (process.stdin.isTTY) {
+        interactiveSetup();
+        return;
+    }
+    // MCP クライアント経由の場合は通常起動
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "narikiri-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AIの口調を着せ替えるMCPペルソナサーバー",
   "type": "module",
   "main": "dist/index.js",