owner-clone-ai-mcp 1.8.0 → 1.9.0

package/index.js

@@ -97,13 +97,34 @@ const TOOLS = [
   // AIパートナー関連（読み取り）
   {
     name: 'load_agent',
-    description: 'AIパートナーの設定（システムプロンプト・ルール・対話フロー）と関連ナレッジを取得します。AIパートナーに設定されたナレッジ参照モード（semantic/full_text/two_step_rag/smart_full_text）でナレッジを検索し、Claude Codeがそのパートナーの人格・知識で回答できるようにします。追加のAI課金は発生しません。',
+    description: `AIパートナーの設定（システムプロンプト・ルール・対話フロー）と関連ナレッジを取得します。
+AIパートナーに設定されたナレッジ参照モードでナレッジを検索し、Claude Codeがそのパートナーの人格・知識で回答できるようにします。追加のAI課金は発生しません。
+
+■ queryパラメータは必ずユーザーの質問文をそのまま渡すこと（要約・言い換え禁止）。
+  セマンティック検索の精度がqueryの文字列に直接依存するため。
+
+■ ナレッジ参照モード別の呼び出し戦略（AIパートナー設定で自動決定）:
+
+【full_text モード】（knowledge_semantic_search=false）
+  → セッション開始時に1回だけ呼べばOK。
+  返ってくるナレッジ全文は毎回同じ（クエリ非依存）なので、
+  Claude Codeのコンテキストに記憶される。2回目以降はload_agentを呼ばずに
+  記憶済みナレッジから直接回答できる。query省略可。
+
+【semantic モード】（デフォルト）
+  → 質問ごとに呼ぶ。queryに質問文を渡すと関連チャンクが変わる。
+
+【smart_full_text モード】
+  → 質問ごとに呼ぶ。queryに質問文を渡す。
+
+【two_step_rag モード】
+  → 質問ごとに呼ぶ。queryに質問文を渡す（クエリ最適化はバックエンドで自動対応）。`,
     annotations: { readOnlyHint: true },
     inputSchema: {
       type: 'object',
       properties: {
         id: { type: 'string', description: 'AIパートナーのID（list_agent_presetsで確認）' },
-        query: { type: 'string', description: 'ユーザーの質問・依頼内容（ナレッジ検索に使用。省略時は全ナレッジを返す）' },
+        query: { type: 'string', description: 'ユーザーの質問文をそのまま渡す（full_textモードは省略可。他モードは必須）' },
       },
       required: ['id'],
     },
@@ -750,6 +771,98 @@ diagnostic_questions / diagnostic_results を渡すと全データが置換さ
       required: ['id', 'step_index'],
     },
   },
+  // プロジェクト管理
+  {
+    name: 'list_projects',
+    description: `プロジェクト一覧を取得します。各プロジェクトのタスク件数と、Chatwork通知設定の紐付け状況を含みます。
+プロジェクトはタスク・スケジュール・ワークフローの実行単位として使用します。
+approval_notify_setting_id が設定されている場合、承認タスク作成時にそのChatworkルームへ通知されます。`,
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'get_project',
+    description: `指定したプロジェクトの詳細とタスク一覧（最新50件）を取得します。
+Chatwork連携が設定されている場合は、設定名とルームIDも返します。`,
+    annotations: { readOnlyHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: 'プロジェクトID' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'create_project',
+    description: `プロジェクトを新規作成します。【書き込み権限付きキーが必要】
+
+■ 各フィールドの役割:
+• name: プロジェクト名（必須）
+• description: 目的・概要のメモ（省略可）
+• color: 管理画面での表示カラー。カラーコード（例: #3b82f6）で指定（省略可）
+• status: 進行状況。"active"（進行中）/ "completed"（完了）/ "archived"（アーカイブ）。デフォルト: "active"
+• due_date: プロジェクトの期限日。ISO8601形式（例: 2026-12-31）（省略可）
+• approval_notify_setting_id: 承認タスク発生時にChatwork通知するための設定ID。
+    list_chatwork_settings で確認したIDを指定。承認フローのあるプロジェクトで設定推奨。`,
+    annotations: { destructiveHint: false, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name:                        { type: 'string',  description: 'プロジェクト名（必須）' },
+        description:                 { type: 'string',  description: 'プロジェクトの目的・概要（省略可）' },
+        color:                       { type: 'string',  description: 'カラーコード（例: #3b82f6）省略可' },
+        status:                      { type: 'string',  description: '進行状況: active（進行中）/ completed（完了）/ archived（アーカイブ）。デフォルト: active', enum: ['active', 'completed', 'archived'] },
+        due_date:                    { type: 'string',  description: '期限日 ISO8601形式（例: 2026-12-31）省略可' },
+        approval_notify_setting_id:  { type: 'string',  description: '承認通知先ChatworkのID（list_chatwork_settingsで確認）省略可' },
+      },
+      required: ['name'],
+    },
+  },
+  {
+    name: 'update_project',
+    description: `既存のプロジェクトを更新します。【書き込み権限付きキーが必要】
+指定したフィールドのみ更新され、省略したフィールドは現在値を維持します。
+due_date や approval_notify_setting_id を null に設定すると値をクリアできます。
+各フィールドの意味は create_project と同じです。`,
+    annotations: { destructiveHint: false, idempotentHint: true },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id:                          { type: 'string',  description: 'プロジェクトID（list_projectsで確認）' },
+        name:                        { type: 'string',  description: '新しいプロジェクト名（省略時は変更なし）' },
+        description:                 { type: 'string',  description: '新しい説明（省略時は変更なし）' },
+        color:                       { type: 'string',  description: '新しいカラーコード（省略時は変更なし）' },
+        status:                      { type: 'string',  description: '新しい進行状況: active / completed / archived（省略時は変更なし）', enum: ['active', 'completed', 'archived'] },
+        due_date:                    { type: 'string',  description: '新しい期限日（null でクリア、省略時は変更なし）' },
+        approval_notify_setting_id:  { type: 'string',  description: '新しいChatwork通知設定ID（null でクリア、省略時は変更なし）' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'delete_project',
+    description: 'プロジェクトを削除します。【書き込み権限付きキーが必要】この操作は元に戻せません。関連タスクの扱いはDB設定に準じます。',
+    annotations: { destructiveHint: true, idempotentHint: false },
+    inputSchema: {
+      type: 'object',
+      properties: {
+        id: { type: 'string', description: '削除するプロジェクトID' },
+      },
+      required: ['id'],
+    },
+  },
+  {
+    name: 'list_chatwork_settings',
+    description: `有効なChatwork連携設定の一覧を取得します（APIトークンは除外）。
+返される id は以下の場面で使用します:
+  • create_project / update_project の approval_notify_setting_id — 承認タスクのChatwork通知先
+  • create_workflow / update_workflow のステップ内 chatwork_setting_id — アクションの送信先
+  • execute_workflow_action の chatwork_setting_id — 直接実行時の送信先
+room_id フィールドはChatworkのルームIDです（設定名と合わせて目的のルームを特定してください）。`,
+    annotations: { readOnlyHint: true },
+    inputSchema: { type: 'object', properties: {} },
+  },
   // 書き込みツール（読み書き可能キーが必要）
   {
     name: 'create_knowledge',
@@ -1204,6 +1317,85 @@ async function executeTool(name, args) {
       return `✅ ${data.message || JSON.stringify(data)}`;
     }
 
+    case 'list_projects': {
+      const data = await callApi('/projects');
+      if (!data.projects || data.projects.length === 0) return 'プロジェクトが登録されていません。';
+      const lines = data.projects.map(p =>
+        `- [${p.id}] ${p.name} [${p.status}]` +
+        (p.due_date ? ` 期限:${p.due_date.slice(0, 10)}` : '') +
+        ` タスク:${p.task_count ?? 0}件` +
+        (p.approval_notify_setting_id ? ` Chatwork通知:あり` : '') +
+        (p.description ? `\n  ${p.description}` : '')
+      );
+      return `プロジェクト一覧（${data.projects.length}件）:\n\n${lines.join('\n')}`;
+    }
+
+    case 'get_project': {
+      const data = await callApi(`/projects/${args.id}`);
+      const parts = [
+        `名前: ${data.name}`,
+        `ステータス: ${data.status}`,
+        data.due_date ? `期限: ${data.due_date.slice(0, 10)}` : '',
+        data.description ? `説明: ${data.description}` : '',
+        data.color ? `カラー: ${data.color}` : '',
+        data.chatwork_setting_name ? `Chatwork通知先: ${data.chatwork_setting_name} (room_id: ${data.chatwork_room_id})` : '',
+        `\nID: ${data.id}`,
+        `作成: ${data.created_at?.slice(0, 10)}`,
+      ].filter(Boolean);
+      let result = parts.join('\n');
+      if (data.tasks && data.tasks.length > 0) {
+        const taskLines = data.tasks.map(t =>
+          `  • [${t.id}] ${t.title} [${t.status}/${t.priority}]` +
+          (t.due_date ? ` 期限:${t.due_date.slice(0, 10)}` : '')
+        );
+        result += `\n\nタスク（${data.tasks.length}件）:\n${taskLines.join('\n')}`;
+      } else {
+        result += '\n\nタスク: なし';
+      }
+      return result;
+    }
+
+    case 'create_project': {
+      const body = {};
+      const pFields = ['name', 'description', 'color', 'status', 'due_date', 'approval_notify_setting_id'];
+      pFields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+      const data = await callApi('/projects', {
+        method: 'POST',
+        body: JSON.stringify(body),
+      });
+      return `✅ ${data.message}\nID: ${data.id}\n名前: ${data.name}\nステータス: ${data.status}` +
+        (data.due_date ? `\n期限: ${data.due_date.slice(0, 10)}` : '');
+    }
+
+    case 'update_project': {
+      const body = {};
+      const pTextFields = ['name', 'description', 'color', 'status'];
+      pTextFields.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+      const pNullable = ['due_date', 'approval_notify_setting_id'];
+      pNullable.forEach(f => { if (args[f] !== undefined) body[f] = args[f]; });
+      const data = await callApi(`/projects/${args.id}`, {
+        method: 'PATCH',
+        body: JSON.stringify(body),
+      });
+      return `✅ ${data.message}\nID: ${data.id}`;
+    }
+
+    case 'delete_project': {
+      const data = await callApi(`/projects/${args.id}`, { method: 'DELETE' });
+      return `✅ ${data.message}\n削除したプロジェクト: ${data.deleted?.name} (ID: ${data.deleted?.id})`;
+    }
+
+    case 'list_chatwork_settings': {
+      const data = await callApi('/chatwork-settings');
+      if (!data.settings || data.settings.length === 0) return 'Chatwork連携設定が登録されていません。管理画面「設定 → 外部連携 → ChatWork」から設定してください。';
+      const lines = data.settings.map(s =>
+        `- [${s.id}] ${s.name} (room_id: ${s.room_id || '未設定'})` +
+        (s.ai_agent_enabled ? ' AI対応' : '') +
+        (s.ai_provider ? ` [${s.ai_provider}]` : '')
+      );
+      return `Chatwork設定一覧（${data.settings.length}件）:\n\n${lines.join('\n')}\n\n※ セキュリティのためAPIトークンは表示されません。`;
+    }
+
     default:
       throw new Error(`Unknown tool: ${name}`);
   }
@@ -1212,7 +1404,7 @@ async function executeTool(name, args) {
 // ── MCPサーバー起動 ────────────────────────────────────────────
 async function main() {
   const server = new Server(
-    { name: 'owner-clone-ai', version: '1.8.0' },
+    { name: 'owner-clone-ai', version: '1.9.0' },
     { capabilities: { tools: {} } }
   );
 

package/package.json

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