owner-clone-ai-mcp 1.0.0 → 1.2.0

package/index.js

@@ -30,9 +30,11 @@ async function callApi(path, options = {}) {
 
 // ── ツール定義 ─────────────────────────────────────────────────
 const TOOLS = [
+  // 読み取り専用ツール
   {
     name: 'search_knowledge',
     description: 'Owner Clone AIのナレッジベースを検索します。セマンティック検索（意味検索）とキーワード検索を使用します。',
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: 'object',
       properties: {
@@ -45,6 +47,7 @@ const TOOLS = [
   {
     name: 'list_knowledge_items',
     description: 'Owner Clone AIに登録されたナレッジの一覧を取得します。フォルダやカテゴリで絞り込み可能。',
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: 'object',
       properties: {
@@ -58,6 +61,7 @@ const TOOLS = [
   {
     name: 'get_knowledge_item',
     description: '指定したIDのナレッジの全文を取得します。',
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: 'object',
       properties: {
@@ -69,16 +73,19 @@ const TOOLS = [
   {
     name: 'list_knowledge_folders',
     description: 'ナレッジのフォルダ一覧を取得します。',
+    annotations: { readOnlyHint: true },
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'list_agent_presets',
     description: 'AIパートナー（エージェントプリセット）の一覧を取得します。システムプリセットも含みます。ナレッジ内容は含みません。',
+    annotations: { readOnlyHint: true },
     inputSchema: { type: 'object', properties: {} },
   },
   {
     name: 'get_agent_preset',
     description: '指定したIDのAIパートナーの詳細（システムプロンプト・ルール）を取得します。セキュリティ上、紐づくナレッジの内容は返しません。',
+    annotations: { readOnlyHint: true },
     inputSchema: {
       type: 'object',
       properties: {
@@ -87,6 +94,146 @@ const TOOLS = [
       required: ['id'],
     },
   },
+  // AIパートナー関連（読み取り）
+  {
+    name: 'load_agent',
+    description: 'AIパートナーの設定（システムプロンプト・ルール・対話フロー）と関連ナレッジを取得します。AIパートナーに設定されたナレッジ参照モード（semantic/full_text/two_step_rag/smart_full_text）でナレッジを検索し、Claude Codeがそのパートナーの人格・知識で回答できるようにします。追加のAI課金は発生しません。',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'AIパートナーのID（list_agent_presetsで確認）' },
+        query: { type: 'string', description: 'ユーザーの質問・依頼内容（ナレッジ検索に使用。省略時は全ナレッジを返す）' },
+      },
+      required: ['id'],
+    },
+  },
+  // ワークフロー関連
+  {
+    name: 'list_workflows',
+    description: 'ワークフロー一覧を取得します。',
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'trigger_workflow',
+    description: '指定したワークフローを起動します。【書き込み権限付きキーが必要】ワークフローは非同期で実行されます。',
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: '起動するワークフローのID' },
+        input: { type: 'object', description: 'ワークフローへの入力データ（省略可）' },
+      },
+      required: ['id'],
+    },
+  },
+  // チャットボット関連
+  {
+    name: 'list_chatbots',
+    description: 'チャットボット一覧を取得します。',
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'get_chatbot',
+    description: '指定したチャットボットの設定詳細（システムプロンプト・ルール・ナレッジ参照モード等）を取得します。',
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'チャットボットのID' },
+      },
+      required: ['id'],
+    },
+  },
+  // AIパートナー書き込み（読み書き可能キーが必要）
+  {
+    name: 'create_agent_preset',
+    description: 'AIパートナーを新規作成します。【書き込み権限付きキーが必要】',
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: { type: 'string', description: 'AIパートナー名' },
+        description: { type: 'string', description: '説明（省略可）' },
+        base_prompt: { type: 'string', description: 'システムプロンプト（人格・役割定義）' },
+        rules_allow: { type: 'string', description: '許可ルール（省略可）' },
+        rules_deny: { type: 'string', description: '禁止ルール（省略可）' },
+        sales_flow: { type: 'string', description: '対話フロー・セールスフロー（省略可）' },
+        knowledge: { type: 'string', description: '直接記述のナレッジテキスト（省略可）' },
+        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '紐づけるナレッジIDの配列（省略可）' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'update_agent_preset',
+    description: '既存のAIパートナーを更新します。【書き込み権限付きキーが必要】システムプリセットは編集不可。',
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: '更新するAIパートナーのID' },
+        name: { type: 'string', description: '新しい名前（省略時は変更なし）' },
+        description: { type: 'string', description: '新しい説明（省略時は変更なし）' },
+        base_prompt: { type: 'string', description: '新しいシステムプロンプト（省略時は変更なし）' },
+        rules_allow: { type: 'string', description: '新しい許可ルール（省略時は変更なし）' },
+        rules_deny: { type: 'string', description: '新しい禁止ルール（省略時は変更なし）' },
+        sales_flow: { type: 'string', description: '新しい対話フロー（省略時は変更なし）' },
+        knowledge: { type: 'string', description: '新しい直接記述ナレッジ（省略時は変更なし）' },
+        knowledge_item_ids: { type: 'array', items: { type: 'string' }, description: '新しいナレッジID配列（省略時は変更なし）' },
+      },
+      required: ['id'],
+    },
+  },
+  // 書き込みツール（読み書き可能キーが必要）
+  {
+    name: 'create_knowledge',
+    description: 'Owner Clone AIにナレッジを新規作成します。【書き込み権限付きキーが必要】作成後、自動的にベクトル化されセマンティック検索に対応します。',
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string', description: 'ナレッジのタイトル' },
+        text_content: { type: 'string', description: 'ナレッジの本文テキスト' },
+        category: {
+          type: 'string',
+          description: 'カテゴリ（product / profile / testimonial / persona / tone / other）',
+          enum: ['product', 'profile', 'testimonial', 'persona', 'tone', 'other'],
+        },
+        folder_id: { type: 'string', description: 'フォルダID（省略可）' },
+      },
+      required: ['title', 'text_content'],
+    },
+  },
+  {
+    name: 'update_knowledge',
+    description: '既存のナレッジを更新します。【書き込み権限付きキーが必要】本文を変更した場合は自動的に再ベクトル化されます。',
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: '更新するナレッジのID' },
+        title: { type: 'string', description: '新しいタイトル（省略時は変更なし）' },
+        text_content: { type: 'string', description: '新しい本文（省略時は変更なし）' },
+        category: { type: 'string', description: '新しいカテゴリ（省略時は変更なし）' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'delete_knowledge',
+    description: '指定したナレッジを削除します。【書き込み権限付きキーが必要】この操作は元に戻せません。',
+    annotations: { destructiveHint: true, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: '削除するナレッジのID' },
+      },
+      required: ['id'],
+    },
+  },
 ];
 
 // ── ツール実行 ─────────────────────────────────────────────────
@@ -155,6 +302,116 @@ async function executeTool(name, args) {
       return parts.join('\n');
     }
 
+    case 'load_agent': {
+      const params = new URLSearchParams();
+      if (args.query) params.set('query', args.query);
+      const data = await callApi(`/agent-presets/${args.id}/context?${params}`);
+      return data.context;
+    }
+
+    case 'list_workflows': {
+      const data = await callApi('/workflows');
+      if (!data.workflows || data.workflows.length === 0) return 'ワークフローが登録されていません。';
+      const lines = data.workflows.map(w =>
+        `- [${w.id}] ${w.title}${w.is_active ? '' : ' (無効)'}\n  ${w.description || ''}`
+      );
+      return `ワークフロー一覧（${data.workflows.length}件）:\n\n${lines.join('\n')}`;
+    }
+
+    case 'trigger_workflow': {
+      const data = await callApi(`/workflows/${args.id}/trigger`, {
+        method: 'POST',
+        body: JSON.stringify({ input: args.input || {} }),
+      });
+      return `✅ ワークフロー「${data.workflow_title}」を起動しました。\n実行ID: ${data.run_id}\nステータス: ${data.status}`;
+    }
+
+    case 'list_chatbots': {
+      const data = await callApi('/chatbots');
+      if (!data.chatbots || data.chatbots.length === 0) return 'チャットボットが登録されていません。';
+      const lines = data.chatbots.map(c =>
+        `- [${c.id}] ${c.name} (モード: ${c.chatbot_mode || 'standard'}) 作成: ${c.created_at?.slice(0, 10)}`
+      );
+      return `チャットボット一覧（${data.chatbots.length}件）:\n\n${lines.join('\n')}`;
+    }
+
+    case 'get_chatbot': {
+      const data = await callApi(`/chatbots/${args.id}`);
+      const mode = data.knowledge_smart_full_text ? 'smart_full_text'
+        : !data.knowledge_semantic_search ? 'full_text'
+        : data.knowledge_query_rewrite ? 'two_step_rag'
+        : 'semantic';
+      const parts = [
+        `名前: ${data.name}`,
+        data.header_title ? `タイトル: ${data.header_title}` : '',
+        `モード: ${data.chatbot_mode || 'standard'}`,
+        `ナレッジ参照: ${mode}`,
+        data.system_prompt ? `\n--- システムプロンプト ---\n${data.system_prompt}` : '',
+        data.rules_allow ? `\n--- 許可ルール ---\n${data.rules_allow}` : '',
+        data.rules_deny  ? `\n--- 禁止ルール ---\n${data.rules_deny}` : '',
+        data.sales_flow  ? `\n--- 対話フロー ---\n${data.sales_flow}` : '',
+      ].filter(Boolean);
+      return parts.join('\n');
+    }
+
+    case 'create_agent_preset': {
+      const data = await callApi('/agent-presets', {
+        method: 'POST',
+        body: JSON.stringify({
+          name: args.name,
+          description: args.description,
+          base_prompt: args.base_prompt,
+          rules_allow: args.rules_allow,
+          rules_deny: args.rules_deny,
+          sales_flow: args.sales_flow,
+          knowledge: args.knowledge,
+          knowledge_item_ids: args.knowledge_item_ids,
+        }),
+      });
+      return `✅ ${data.message}\nID: ${data.id}\n名前: ${data.name}\n作成日時: ${data.created_at}`;
+    }
+
+    case 'update_agent_preset': {
+      const body = {};
+      const fields = ['name','description','base_prompt','rules_allow','rules_deny','sales_flow','knowledge','knowledge_item_ids'];
+      fields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+      const data = await callApi(`/agent-presets/${args.id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+      return `✅ ${data.message}\nID: ${data.id}\n名前: ${data.name}\n更新日時: ${data.updated_at}`;
+    }
+
+    case 'create_knowledge': {
+      const data = await callApi('/knowledge', {
+        method: 'POST',
+        body: JSON.stringify({
+          title: args.title,
+          text_content: args.text_content,
+          category: args.category || 'other',
+          folder_id: args.folder_id,
+        }),
+      });
+      return `✅ ${data.message}\nID: ${data.id}\nタイトル: ${data.title}\nカテゴリ: ${data.category}\n作成日時: ${data.created_at}`;
+    }
+
+    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;
+      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}`;
+    }
+
+    case 'delete_knowledge': {
+      const data = await callApi(`/knowledge/${args.id}`, { method: 'DELETE' });
+      return `✅ ${data.message}\n削除したナレッジ: ${data.deleted.title} (ID: ${data.deleted.id})`;
+    }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }
@@ -163,7 +420,7 @@ async function executeTool(name, args) {
 // ── MCPサーバー起動 ────────────────────────────────────────────
 async function main() {
   const server = new Server(
-    { name: 'owner-clone-ai', version: '1.0.0' },
+    { name: 'owner-clone-ai', version: '1.2.0' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

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