owner-clone-ai-mcp 1.29.2 → 1.31.0

package/domains/knowledge.js

@@ -43,6 +43,16 @@ const tools = [
       required: ['id'],
     },
   },
+  {
+    name: 'get_knowledge_image',
+    description: '画像カテゴリ（image）のナレッジの画像そのものを取得して内容を視覚的に確認します。画像に何が写っているか・見た目を判断する必要があるときに使います。',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: { id: { type: 'string', description: '画像ナレッジのID' } },
+      required: ['id'],
+    },
+  },
   {
     name: 'list_knowledge_folders',
     description: 'ナレッジのフォルダ一覧を取得します。',
@@ -51,27 +61,42 @@ const tools = [
   },
   {
     name: 'create_knowledge',
-    description: 'Owner Clone AIにナレッジを新規作成します。【書き込み権限付きキーが必要】作成後、自動的にベクトル化されセマンティック検索に対応します。',
+    description: `Owner Clone AIにナレッジを新規作成します。【書き込み権限付きキーが必要】作成後、自動的にベクトル化されセマンティック検索に対応します。
+
+text_content（自由テキスト）か、content（カテゴリ別の構造化オブジェクト）のどちらかを渡してください。
+content を渡すと各入力項目が正しく構造化保存され、本文テキストは自動生成されます（UIフォームと同じ扱い）。
+
+■ content のカテゴリ別フィールド（カテゴリに合わせて設定）:
+  persona: persona_name(お名前) / age_gender(年齢) / gender(性別:男性|女性|その他) / job / concerns(緊急性のある悩みTOP3) / level(初級者|中級者|上級者) / level_reason / special_words / past_failures / wants(具体的ゴール) / info_source / purchase_behavior / why_instant_sell
+  profile: company_name / founded(設立年・事業開始年) / business / achievements / media / expertise(専門性) / representative
+  testimonial: publish_consent(掲載可否:全て掲載可|名前を伏せて掲載可|掲載不可) / service_name / customer_name / industry / self_intro / before_reason / results / how_achieved / beyond_expect / surrounding / recommend_for
+  tone: base_style / expressions / avoid / length_style / layout("mobile"=スマホ対応|"pc"=PC最適化) / sample
+  product: product_name / category(商品ジャンル) / price / urgent_problems / why_created / for_whom / services(★配列)
+  offer: offer_name / offer_type(メルマガ・公式LINEの登録誘導|資料・サンプル請求|個別相談・セミナー開催|チャレンジ企画|ウェビナー|その他) / price / duration / urgent_problems / why_created / for_whom / bonuses / guarantee / services(★配列) / objections / cta
+  other / note_manual / note_research / note_hint / note_article / note_meeting: body
+■ product/offer の services（繰り返し複合・オブジェクト配列）:
+  services: [{ name:"サービス名", value:"いくらの価値があるか", result_1m:"1ヶ月で見込める結果", result_3m:"3ヶ月で見込める結果", result_6m:"6ヶ月で見込める結果", advantages:"競合より優れている3つの理由" }, ...複数可]`,
     annotations: { destructiveHint: false, idempotentHint: false },
     inputSchema: {
       type: 'object',
       properties: {
         title:        { type: 'string', description: 'ナレッジのタイトル' },
-        text_content: { type: 'string', description: 'ナレッジの本文テキスト' },
+        text_content: { type: 'string', description: 'ナレッジの本文テキスト（content を渡す場合は不要）' },
+        content:      { type: 'object', description: 'カテゴリ別の構造化オブジェクト（上記参照）。渡すと本文テキストは自動生成される。product/offer の services は配列' },
         category: {
           type: 'string',
-          description: 'カテゴリ（product / profile / testimonial / persona / tone / other）',
-          enum: ['product', 'profile', 'testimonial', 'persona', 'tone', 'other'],
+          description: 'カテゴリ',
+          enum: ['offer', 'product', 'profile', 'testimonial', 'persona', 'tone', 'other', 'note_manual', 'note_research', 'note_hint', 'note_article', 'note_meeting'],
         },
         folder_id: { type: 'string', description: 'フォルダID（省略可）' },
         tags:      { type: 'array', items: { type: 'string' }, description: 'タグの配列（例: ["マーケティング", "集客"]）省略可。省略時はタグなしで登録。' },
       },
-      required: ['title', 'text_content'],
+      required: ['title'],
     },
   },
   {
     name: 'update_knowledge',
-    description: '既存のナレッジを更新します。【書き込み権限付きキーが必要】本文を変更した場合は自動的に再ベクトル化されます。folder_id でフォルダ移動も可能（null で未分類に移動）。',
+    description: '既存のナレッジを更新します。【書き込み権限付きキーが必要】本文を変更した場合は自動的に再ベクトル化されます。folder_id でフォルダ移動も可能（null で未分類に移動）。content（カテゴリ別構造化オブジェクト）を渡すと構造化保存＋本文自動生成（フィールド仕様は create_knowledge 参照）。',
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
@@ -79,6 +104,7 @@ const tools = [
         id:           { type: 'string', description: '更新するナレッジのID' },
         title:        { type: 'string', description: '新しいタイトル（省略時は変更なし）' },
         text_content: { type: 'string', description: '新しい本文（省略時は変更なし）' },
+        content:      { type: 'object', description: 'カテゴリ別の構造化オブジェクト（create_knowledge参照）。渡すと本文を自動再生成。product/offer の services は配列' },
         category:     { type: 'string', description: '新しいカテゴリ（省略時は変更なし）' },
         folder_id:    { type: 'string', description: '移動先フォルダID（null または省略で変更なし、空文字列で未分類へ移動）' },
         tags:         { type: 'array', items: { type: 'string' }, description: 'タグの配列（省略時は変更なし、空配列[]でタグを全削除）' },
@@ -291,7 +317,19 @@ const handlers = {
     const data = await callApi(`/knowledge/${args.id}`);
     const tagLine = data.tags?.length ? `\nタグ: ${data.tags.join(', ')}` : '\nタグ: なし';
     const folderLine = data.folder_id ? `\nフォルダID: ${data.folder_id}` : '\nフォルダ: 未分類';
-    return `タイトル: ${data.title}\nカテゴリ: ${data.category || 'その他'}${tagLine}${folderLine}\n作成日: ${data.created_at?.slice(0, 10)} / 更新日: ${data.updated_at?.slice(0, 10)}\n\n--- 内容 ---\n${data.text_content}`;
+    const imgHint = data.category === 'image' ? '\n\n※これは画像ナレッジです。画像そのものを見るには get_knowledge_image を使ってください。' : '';
+    return `タイトル: ${data.title}\nカテゴリ: ${data.category || 'その他'}${tagLine}${folderLine}\n作成日: ${data.created_at?.slice(0, 10)} / 更新日: ${data.updated_at?.slice(0, 10)}${imgHint}\n\n--- 内容 ---\n${data.text_content}`;
+  },
+
+  // 画像本体を取得して MCP の image コンテンツとして返す（Claude Desktop等でAIが視認できる）
+  async get_knowledge_image(args) {
+    const data = await callApi(`/knowledge/${args.id}/image`);
+    return {
+      content: [
+        { type: 'text', text: `画像「${data.title || ''}」` },
+        { type: 'image', data: data.base64, mimeType: data.mimeType || 'image/png' },
+      ],
+    };
   },
 
   async list_knowledge_folders(args) {
@@ -311,6 +349,7 @@ const handlers = {
       body: JSON.stringify({
         title: args.title, text_content: args.text_content,
         category: args.category || 'other', folder_id: args.folder_id,
+        ...(args.content !== undefined ? { content: args.content } : {}),
         ...(args.tags !== undefined ? { tags: args.tags } : {}),
       }),
     });
@@ -322,6 +361,7 @@ const handlers = {
     const body = {};
     if (args.title)                    body.title = args.title;
     if (args.text_content)             body.text_content = args.text_content;
+    if (args.content !== undefined)    body.content = args.content;
     if (args.category)                 body.category = args.category;
     if (args.folder_id !== undefined)  body.folder_id = args.folder_id || null;
     if (args.tags !== undefined)       body.tags = args.tags;

package/domains/schedulesAndTasks.js

@@ -88,7 +88,7 @@ const tools = [
   },
   {
     name: 'create_task',
-    description: 'タスクを新規作成します（type=manual）。【書き込み権限付きキーが必要】',
+    description: 'タスクを新規作成します（type=manual）。担当者(assignee)とプロジェクト(project)も指定できます。【書き込み権限付きキーが必要】',
     annotations: { destructiveHint: false, idempotentHint: false },
     inputSchema: {
       type: 'object',
@@ -97,13 +97,18 @@ const tools = [
         body:     { type: 'string', description: '詳細・内容（省略可）' },
         priority: { type: 'string', description: '優先度: low/normal/high（デフォルト: normal）' },
         due_date: { type: 'string', description: '期限日時 ISO8601（省略可）' },
+        assignee_id:   { type: 'string', description: '担当者のメンバーID（list_team_members で取得したUUID）。オーナー自身のID指定も可。' },
+        assignee_name: { type: 'string', description: '担当者の名前（部分一致で検索）。assignee_id を指定しない場合に使用。' },
+        project_id:    { type: 'string', description: 'このタスクを紐づけるプロジェクトのID（list_projects で取得したUUID）' },
+        notify_assignee: { type: 'boolean', description: '担当者にChatworkで通知するか（デフォルト: false。trueで通知）' },
+        notify_chatwork_setting_id: { type: 'string', description: '担当者通知の送信先ChatworkグループID（list_chatwork_settings で取得。未指定時は自動選択）' },
       },
       required: ['title'],
     },
   },
   {
     name: 'update_task',
-    description: 'タスクを更新します。【書き込み権限付きキーが必要】manual タスクは全フィールド更新可。他タイプはステータス変更のみ可。',
+    description: 'タスクを更新します。担当者(assignee)・プロジェクト(project)も変更できます。【書き込み権限付きキーが必要】manual タスクは全フィールド更新可。他タイプはステータス変更のみ可。',
     annotations: { destructiveHint: false, idempotentHint: true },
     inputSchema: {
       type: 'object',
@@ -114,6 +119,9 @@ const tools = [
         priority: { type: 'string', description: '新しい優先度: low/normal/high（manual のみ）' },
         due_date: { type: 'string', description: '新しい期限（manual のみ、null で期限解除）' },
         status:   { type: 'string', description: 'ステータス変更: pending/done/dismissed' },
+        assignee_id:   { type: 'string', description: '担当者のメンバーID（list_team_members のUUID。空文字で担当者解除）' },
+        assignee_name: { type: 'string', description: '担当者の名前（部分一致）。"解除"で担当者を外す。' },
+        project_id:    { type: 'string', description: '紐づけるプロジェクトのID（list_projects のUUID。空文字で解除）' },
       },
       required: ['id'],
     },
@@ -207,18 +215,20 @@ const handlers = {
   },
 
   async create_task(args) {
-    const data = await callApi('/tasks', {
-      method: 'POST',
-      body: JSON.stringify({ title: args.title, body: args.body, priority: args.priority, due_date: args.due_date }),
-    });
+    const body = {};
+    ['title','body','priority','due_date','assignee_id','assignee_name','project_id','notify_assignee','notify_chatwork_setting_id']
+      .forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+    const data = await callApi('/tasks', { method: 'POST', body: JSON.stringify(body) });
     return `✅ ${data.message}\nID: ${data.id}\nタイトル: ${data.title}\n優先度: ${data.priority}` +
-      (data.due_date ? `\n期限: ${data.due_date.slice(0, 10)}` : '');
+      (data.due_date ? `\n期限: ${data.due_date.slice(0, 10)}` : '') +
+      (data.assignee_id ? `\n担当者ID: ${data.assignee_id}` : '') +
+      (data.project_id ? `\nプロジェクトID: ${data.project_id}` : '');
   },
 
   async update_task(args) {
     const body = {};
-    const tFields = ['title','body','priority','due_date','status'];
-    tFields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+    ['title','body','priority','due_date','status','assignee_id','assignee_name','project_id']
+      .forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
     const data = await callApi(`/tasks/${args.id}`, { method: 'PATCH', body: JSON.stringify(body) });
     return `✅ ${data.message}\nID: ${data.id}`;
   },

package/index.js

@@ -45,6 +45,10 @@ async function main() {
     const { name, arguments: args } = request.params;
     try {
       const result = await executeTool(name, args || {});
+      // ハンドラが MCP コンテンツ（画像など）を直接返した場合はそのまま返す
+      if (result && typeof result === 'object' && Array.isArray(result.content)) {
+        return result;
+      }
       return { content: [{ type: 'text', text: result }] };
     } catch (err) {
       return {

package/lib/api.js

@@ -14,7 +14,11 @@ async function callApi(path, options = {}) {
     },
   });
   const json = await res.json();
-  if (!res.ok) throw new Error(json.error || `API error ${res.status}`);
+  if (!res.ok) {
+    // バックエンドが detail（DB例外メッセージ等）を返す場合は原因特定のため併記
+    const msg = json && json.detail ? `${json.error || 'エラー'}: ${json.detail}` : (json.error || `API error ${res.status}`);
+    throw new Error(msg);
+  }
   return json;
 }
 

package/package.json

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