owner-clone-ai-mcp 1.0.0 → 1.1.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,53 @@ const TOOLS = [
       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 +209,36 @@ async function executeTool(name, args) {
       return parts.join('\n');
     }
 
+    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 +247,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.1.0' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

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