owner-clone-ai-mcp 1.13.2 → 1.14.0

package/index.js

@@ -1019,7 +1019,7 @@ room_id フィールドはChatworkのルームIDです（設定名と合わせ
   },
   {
     name: 'update_knowledge_folder',
-    description: 'ナレッジフォルダの名前またはカラーを変更します。【書き込み権限付きキーが必要】',
+    description: 'ナレッジフォルダの名前・カラー・説明を変更します。【書き込み権限付きキーが必要】',
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
@@ -1027,6 +1027,7 @@ room_id フィールドはChatworkのルームIDです（設定名と合わせ
         id: { type: 'string', description: '更新するフォルダのID' },
         name: { type: 'string', description: '新しいフォルダ名（省略時は変更なし）' },
         color: { type: 'string', description: '新しいカラー（省略時は変更なし）' },
+        description: { type: 'string', description: 'フォルダの説明（省略時は変更なし）' },
       },
       required: ['id'],
     },
@@ -1109,7 +1110,7 @@ room_id フィールドはChatworkのルームIDです（設定名と合わせ
   },
   {
     name: 'update_knowledge',
-    description: '既存のナレッジを更新します。【書き込み権限付きキーが必要】本文を変更した場合は自動的に再ベクトル化されます。',
+    description: '既存のナレッジを更新します。【書き込み権限付きキーが必要】本文を変更した場合は自動的に再ベクトル化されます。folder_id でフォルダ移動も可能（null で未分類に移動）。',
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
@@ -1118,6 +1119,7 @@ room_id フィールドはChatworkのルームIDです（設定名と合わせ
         title: { type: 'string', description: '新しいタイトル（省略時は変更なし）' },
         text_content: { type: 'string', description: '新しい本文（省略時は変更なし）' },
         category: { type: 'string', description: '新しいカテゴリ（省略時は変更なし）' },
+        folder_id: { type: 'string', description: '移動先フォルダID（null または省略で変更なし、空文字列で未分類へ移動）' },
       },
       required: ['id'],
     },
@@ -1134,6 +1136,69 @@ room_id フィールドはChatworkのルームIDです（設定名と合わせ
       required: ['id'],
     },
   },
+  {
+    name: 'generate_folder_description',
+    description: `指定フォルダのナレッジ内容をAIが分析し、フォルダ説明を自動生成します。【書き込み権限付きキーが必要・AIコスト発生】
+
+⚠️ 【必須】このツールを呼ぶ前に、必ずユーザーへ実行方法を確認してください ⚠️
+フォルダ説明の生成には2つの方法があります。ユーザーが明示的に選択するまでこのツールを呼んではいけません。
+
+  【方法A】Owner Clone AI で生成（このツール）
+    - Owner Clone AI サーバーのAIがフォルダ内ナレッジを読み込んで説明を生成
+    - save=true を指定すると生成後に自動でフォルダに保存
+
+  【方法B】Claude Code が直接実行
+    - list_knowledge_items(folder_id=xxx) でフォルダ内容を取得
+    - Claude Code 自身が内容を分析して説明を生成
+    - update_knowledge_folder(id=xxx, description="生成した説明") で保存
+
+ユーザーに「方法A（Owner Clone AIで生成）」「方法B（Claude Codeが直接実行）」のどちらにするか確認し、
+「方法A」を選んだ場合のみこのツールを呼んでください。`,
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        folder_id: { type: 'string', description: '説明を生成するフォルダのID' },
+        provider: { type: 'string', description: 'AIプロバイダー（claude / openai / gemini / openrouter / groq。デフォルト: openai）', enum: ['claude', 'openai', 'gemini', 'openrouter', 'groq'] },
+        model: { type: 'string', description: '使用モデル（省略時はプロバイダーのデフォルトモデル）' },
+        save: { type: 'boolean', description: '生成後にフォルダへ自動保存するか（デフォルト: false）' },
+      },
+      required: ['folder_id'],
+    },
+  },
+  {
+    name: 'ai_reorganize_folders',
+    description: `全フォルダとナレッジをAIが分析し、より適切なフォルダへの移動提案を生成します。【書き込み権限付きキーが必要・AIコスト発生】
+フォルダに説明（description）が設定されていると提案精度が向上します。
+
+⚠️ 【必須】このツールを呼ぶ前に、必ずユーザーへ実行方法を確認してください ⚠️
+フォルダ整理には2つの方法があります。ユーザーが明示的に選択するまでこのツールを呼んではいけません。
+
+  【方法A】Owner Clone AI で実行（このツール）
+    - Owner Clone AI サーバーのAIが全フォルダ・ナレッジを分析して移動提案を返す
+    - 提案一覧を受け取り、承認した提案を update_knowledge(id, folder_id=to_folder_id) で実行
+
+  【方法B】Claude Code が直接実行
+    - list_knowledge_folders() でフォルダ一覧を取得
+    - list_knowledge_items() でナレッジ一覧を取得
+    - Claude Code 自身が内容を分析して移動先を提案
+    - ユーザー承認後、update_knowledge(id=xxx, folder_id=xxx) で移動を実行
+
+ユーザーに「方法A（Owner Clone AIで実行）」「方法B（Claude Codeが直接実行）」のどちらにするか確認し、
+「方法A」を選んだ場合のみこのツールを呼んでください。
+
+■ 提案の実行方法:
+  返ってきた proposals の各アイテムについて、ユーザーが承認したものを
+  update_knowledge(id=item_id, folder_id=to_folder_id) で実行してください。`,
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        provider: { type: 'string', description: 'AIプロバイダー（claude / openai / gemini / openrouter / groq。デフォルト: openai）', enum: ['claude', 'openai', 'gemini', 'openrouter', 'groq'] },
+        model: { type: 'string', description: '使用モデル（省略時はプロバイダーのデフォルトモデル）' },
+      },
+    },
+  },
 ];
 
 // ── ツール実行 ─────────────────────────────────────────────────
@@ -1175,7 +1240,7 @@ async function executeTool(name, args) {
     case 'list_knowledge_folders': {
       const data = await callApi('/knowledge-folders');
       if (!data.folders || data.folders.length === 0) return 'フォルダが作成されていません。';
-      const lines = data.folders.map(f => `- [${f.id}] ${f.name}`);
+      const lines = data.folders.map(f => `- [${f.id}] ${f.name}${f.description ? `\n  説明: ${f.description}` : ''}`);
       return `フォルダ一覧（${data.folders.length}件）:\n\n${lines.join('\n')}`;
     }
 
@@ -1343,9 +1408,9 @@ async function executeTool(name, args) {
     case 'update_knowledge_folder': {
       const data = await callApi(`/knowledge-folders/${args.id}`, {
         method: 'PUT',
-        body: JSON.stringify({ name: args.name, color: args.color }),
+        body: JSON.stringify({ name: args.name, color: args.color, ...(args.description !== undefined ? { description: args.description } : {}) }),
       });
-      return `✅ ${data.message}\nID: ${data.id}\nフォルダ名: ${data.name}`;
+      return `✅ ${data.message}\nID: ${data.id}\nフォルダ名: ${data.name}${data.description ? `\n説明: ${data.description}` : ''}`;
     }
 
     case 'reorder_knowledge_folders': {
@@ -1396,14 +1461,15 @@ async function executeTool(name, args) {
 
     case 'update_knowledge': {
       const body = {};
-      if (args.title)        body.title = args.title;
-      if (args.text_content) body.text_content = args.text_content;
-      if (args.category)     body.category = args.category;
+      if (args.title)                 body.title = args.title;
+      if (args.text_content)          body.text_content = args.text_content;
+      if (args.category)              body.category = args.category;
+      if (args.folder_id !== undefined) body.folder_id = args.folder_id || null;
       const data = await callApi(`/knowledge/${args.id}`, {
         method: 'PATCH',
         body: JSON.stringify(body),
       });
-      return `✅ ${data.message}\nID: ${data.id}\nタイトル: ${data.title}\n更新日時: ${data.updated_at}`;
+      return `✅ ${data.message}\nID: ${data.id}\nタイトル: ${data.title}\n更新日時: ${data.updated_at}${data.folder_id ? `\nフォルダID: ${data.folder_id}` : '\nフォルダ: 未分類'}`;
     }
 
     case 'delete_knowledge': {
@@ -1411,6 +1477,29 @@ async function executeTool(name, args) {
       return `✅ ${data.message}\n削除したナレッジ: ${data.deleted.title} (ID: ${data.deleted.id})`;
     }
 
+    case 'generate_folder_description': {
+      const data = await callApi(`/knowledge-folders/${args.folder_id}/generate-description`, {
+        method: 'POST',
+        body: JSON.stringify({ provider: args.provider, model: args.model, save: args.save }),
+      });
+      const saveNote = data.saved ? '（フォルダに保存済み）' : '（未保存 — update_knowledge_folder で保存可能）';
+      return `✅ ${data.message}\nフォルダ名: ${data.folder_name}\n\n生成された説明 ${saveNote}:\n${data.description}`;
+    }
+
+    case 'ai_reorganize_folders': {
+      const data = await callApi('/knowledge-folders/ai-reorganize', {
+        method: 'POST',
+        body: JSON.stringify({ provider: args.provider, model: args.model }),
+      });
+      if (!data.proposals || data.proposals.length === 0) {
+        return `✅ 分析完了。現在の配置は適切です。移動の提案はありません。`;
+      }
+      const lines = data.proposals.map((p, i) =>
+        `[${i + 1}] ${p.item_title}\n    ID: ${p.item_id}\n    ${p.from_folder_name} → ${p.to_folder_name}（移動先ID: ${p.to_folder_id}）\n    理由: ${p.reason}`
+      );
+      return `✅ ${data.message}\n\n【移動提案一覧】\n${lines.join('\n\n')}\n\n--- 承認した提案を実行するには ---\nupdate_knowledge(id=<item_id>, folder_id=<to_folder_id>) を各提案について呼んでください。`;
+    }
+
     case 'list_schedules': {
       const params = new URLSearchParams();
       if (args.from) params.set('from', args.from);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owner-clone-ai-mcp",
-  "version": "1.13.2",
+  "version": "1.14.0",
   "description": "MCP server for Owner Clone AI — exposes knowledge and agent presets to Claude Code",
   "main": "index.js",
   "bin": {