senq-mcp 1.3.0 → 1.4.1

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+export declare const BASE_URL: string;
 export declare function apiGet<T>(path: string, params?: Record<string, string>): Promise<T>;
 export declare function apiPost<T>(path: string, body: unknown): Promise<T>;
 export declare function apiPatch<T>(path: string, body: unknown): Promise<T>;

package/dist/client.js

@@ -1,4 +1,4 @@
-const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
+export const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
 function getApiKey() {
     const key = process.env.SENQ_API_KEY ?? "";
     if (!key) {

package/dist/index.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { apiGet, apiPost, apiPatch } from "./client.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { apiGet, apiPost, apiPatch, BASE_URL } from "./client.js";
 import { storePending, consumePending } from "./pending-changes.js";
 if (process.argv[2] === "setup") {
     const { runSetup } = await import("./setup.js");
     await runSetup();
     process.exit(0);
 }
-const server = new Server({ name: "senq-mcp", version: "1.3.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "senq-mcp", version: "1.4.1" }, { capabilities: { tools: {}, prompts: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -106,6 +106,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "find_employee",
+            description: "Найти сотрудника по имени или email. Возвращает ID, который нужен для list_team_tasks и get_team_report.",
+            inputSchema: {
+                type: "object",
+                required: ["name"],
+                properties: {
+                    name: { type: "string", description: "Имя, фамилия или email сотрудника" },
+                },
+            },
+        },
         {
             name: "list_team_tasks",
             description: "Задачи сотрудника — только для администраторов. Возвращает все задачи, где сотрудник является исполнителем. Можно фильтровать по проекту, области, статусу и диапазону дат.",
@@ -141,6 +152,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
     ],
 }));
+function withUrl(task) {
+    if (typeof task.id === "string") {
+        return { ...task, url: `${BASE_URL}/#/tasks/${task.id}` };
+    }
+    return task;
+}
+function withUrls(tasks) {
+    return tasks.map((t) => withUrl(t));
+}
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
     const { name, arguments: args } = req.params;
     try {
@@ -157,19 +177,36 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             if (args?.limit)
                 params.limit = String(args.limit);
             const data = await apiGet("/api/tasks", params);
-            const tasks = data.tasks ?? (Array.isArray(data) ? data : []);
+            const tasks = withUrls(data.tasks ?? (Array.isArray(data) ? data : []));
             return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
         }
         if (name === "get_task") {
             const id = String(args?.id ?? "");
             const data = await apiGet(`/api/tasks/${id}`);
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            return { content: [{ type: "text", text: JSON.stringify(withUrl(data), null, 2) }] };
         }
         if (name === "search_tasks") {
             const query = String(args?.query ?? "");
             const limit = args?.limit ? String(args.limit) : "10";
             const data = await apiGet("/api/tasks/search", { q: query, limit });
-            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+            const tasks = withUrls(data.tasks ?? (Array.isArray(data) ? data : []));
+            return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
+        }
+        if (name === "find_employee") {
+            const query = String(args?.name ?? "").toLowerCase().trim();
+            if (!query)
+                return { content: [{ type: "text", text: "Ошибка: name обязателен" }] };
+            const data = await apiGet("/api/registry");
+            const employees = data.employees ?? [];
+            const found = employees.filter((e) => {
+                const name = (e.displayName ?? "").toLowerCase();
+                const email = (e.email ?? "").toLowerCase();
+                return name.includes(query) || email.includes(query);
+            });
+            if (!found.length)
+                return { content: [{ type: "text", text: `Сотрудник «${args?.name}» не найден` }] };
+            const result = found.map((e) => ({ id: e.id, displayName: e.displayName, email: e.email, profileUrl: `${BASE_URL}/#/team/${e.id}` }));
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         if (name === "propose_task_change") {
             const action = String(args?.action ?? "create");
@@ -290,12 +327,17 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             if (args?.offset)
                 params.offset = String(args.offset);
             const data = await apiGet("/api/tasks/team", params);
-            const tasks = data.tasks ?? [];
+            const tasks = withUrls(data.tasks ?? []).map((t) => {
+                if (typeof t.assigneeId === "string") {
+                    return { ...t, assigneeUrl: `${BASE_URL}/#/team/${t.assigneeId}` };
+                }
+                return t;
+            });
             const total = data.total ?? tasks.length;
             return {
                 content: [{
                         type: "text",
-                        text: `Найдено задач: ${total}\n\n${JSON.stringify(tasks, null, 2)}`,
+                        text: `Найдено задач: ${total}\n\nПри отображении форматируй названия задач как markdown-ссылки [название](url), имена исполнителей — как [имя](assigneeUrl).\n\n${JSON.stringify(tasks, null, 2)}`,
                     }],
             };
         }
@@ -326,7 +368,18 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
             const completedLate = filtered.filter((t) => t.status === "completed" && t.dueDate && t.completedAt && t.completedAt.slice(0, 10) > t.dueDate);
             const overdue = filtered.filter((t) => t.status === "open" && t.dueDate && t.dueDate < today);
             const inProgress = filtered.filter((t) => t.status === "open" && t.dueDate && t.dueDate >= today);
-            const fmt = (list) => list.map((t) => `  • ${t.title} (срок: ${t.dueDate ?? "—"}${t.completedAt ? `, выполнена: ${t.completedAt.slice(0, 10)}` : ""}${t.projectName ? `, проект: ${t.projectName}` : ""})`).join("\n");
+            const fmt = (list) => list.map((t) => {
+                const taskUrl = `${BASE_URL}/#/tasks/${t.id}`;
+                const assigneePart = t.assigneeName
+                    ? `, [${t.assigneeName}](${BASE_URL}/#/team/${assigneeId})`
+                    : "";
+                const parts = [`срок: ${t.dueDate ?? "—"}`];
+                if (t.completedAt)
+                    parts.push(`выполнена: ${t.completedAt.slice(0, 10)}`);
+                if (t.projectName)
+                    parts.push(`проект: ${t.projectName}`);
+                return `  • [${t.title}](${taskUrl}) (${parts.join(", ")}${assigneePart})`;
+            }).join("\n");
             const period = dateFrom || dateTo ? ` (период: ${dateFrom ?? "..."} — ${dateTo ?? "..."})` : "";
             const lines = [
                 `Отчёт по сотруднику${period}`,
@@ -353,5 +406,69 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         return { content: [{ type: "text", text: `Ошибка: ${msg}` }], isError: true };
     }
 });
+const PROMPTS = [
+    {
+        name: "задачи-сегодня",
+        description: "Что у меня запланировано на сегодня",
+        arguments: [],
+    },
+    {
+        name: "что-просрочено",
+        description: "Мои просроченные задачи и дедлайны",
+        arguments: [],
+    },
+    {
+        name: "создать-задачу",
+        description: "Создать новую задачу",
+        arguments: [{ name: "описание", description: "Что нужно сделать", required: true }],
+    },
+    {
+        name: "отчёт-сотрудника",
+        description: "Отчёт по задачам сотрудника за период (для руководителей)",
+        arguments: [
+            { name: "сотрудник", description: "Имя или email сотрудника", required: true },
+            { name: "период", description: "Например: июнь 2026 или 2026-06-01 / 2026-06-30", required: false },
+        ],
+    },
+    {
+        name: "найти-задачу",
+        description: "Найти задачу по теме или ключевым словам",
+        arguments: [{ name: "тема", description: "Что искать", required: true }],
+    },
+];
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: PROMPTS.map(({ name, description, arguments: args }) => ({
+        name,
+        description,
+        arguments: args,
+    })),
+}));
+server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+    const { name, arguments: promptArgs } = req.params;
+    const messages = [];
+    if (name === "задачи-сегодня") {
+        messages.push({ role: "user", content: { type: "text", text: "Покажи мои задачи на сегодня" } });
+    }
+    else if (name === "что-просрочено") {
+        messages.push({ role: "user", content: { type: "text", text: "Что у меня просрочено? Покажи задачи с прошедшим дедлайном" } });
+    }
+    else if (name === "создать-задачу") {
+        const desc = promptArgs?.["описание"] ?? "...";
+        messages.push({ role: "user", content: { type: "text", text: `Создай задачу: ${desc}` } });
+    }
+    else if (name === "отчёт-сотрудника") {
+        const emp = promptArgs?.["сотрудник"] ?? "...";
+        const period = promptArgs?.["период"] ? ` за ${promptArgs["период"]}` : "";
+        messages.push({ role: "user", content: { type: "text", text: `Сначала найди сотрудника «${emp}» через find_employee, затем сделай отчёт по его задачам${period}: что просрочено, что выполнено вовремя, что в работе` } });
+    }
+    else if (name === "найти-задачу") {
+        const topic = promptArgs?.["тема"] ?? "...";
+        messages.push({ role: "user", content: { type: "text", text: `Найди задачи по теме: ${topic}` } });
+    }
+    else {
+        messages.push({ role: "user", content: { type: "text", text: name } });
+    }
+    return { messages };
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "senq-mcp",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "MCP server for Senq — connect your AI to tasks and knowledge",
   "type": "module",
   "bin": {

package/src/client.ts

@@ -1,4 +1,4 @@
-const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
+export const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
 
 function getApiKey(): string {
   const key = process.env.SENQ_API_KEY ?? "";

package/src/index.ts

@@ -4,8 +4,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
-import { apiGet, apiPost, apiPatch } from "./client.js";
+import { apiGet, apiPost, apiPatch, BASE_URL } from "./client.js";
 import { storePending, consumePending } from "./pending-changes.js";
 
 if (process.argv[2] === "setup") {
@@ -15,8 +17,8 @@ if (process.argv[2] === "setup") {
 }
 
 const server = new Server(
-  { name: "senq-mcp", version: "1.3.0" },
-  { capabilities: { tools: {} } },
+  { name: "senq-mcp", version: "1.4.1" },
+  { capabilities: { tools: {}, prompts: {} } },
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -115,6 +117,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
       },
     },
+    {
+      name: "find_employee",
+      description: "Найти сотрудника по имени или email. Возвращает ID, который нужен для list_team_tasks и get_team_report.",
+      inputSchema: {
+        type: "object",
+        required: ["name"],
+        properties: {
+          name: { type: "string", description: "Имя, фамилия или email сотрудника" },
+        },
+      },
+    },
     {
       name: "list_team_tasks",
       description: "Задачи сотрудника — только для администраторов. Возвращает все задачи, где сотрудник является исполнителем. Можно фильтровать по проекту, области, статусу и диапазону дат.",
@@ -151,6 +164,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
   ],
 }));
 
+type TaskLike = Record<string, unknown>;
+
+function withUrl(task: TaskLike): TaskLike {
+  if (typeof task.id === "string") {
+    return { ...task, url: `${BASE_URL}/#/tasks/${task.id}` };
+  }
+  return task;
+}
+
+function withUrls(tasks: unknown[]): TaskLike[] {
+  return tasks.map((t) => withUrl(t as TaskLike));
+}
+
 server.setRequestHandler(CallToolRequestSchema, async (req) => {
   const { name, arguments: args } = req.params;
 
@@ -163,21 +189,37 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       if (args?.status) params.status = String(args.status);
       if (args?.limit) params.limit = String(args.limit);
       const data = await apiGet<{ tasks?: unknown[] }>("/api/tasks", params);
-      const tasks = data.tasks ?? (Array.isArray(data) ? data : []);
+      const tasks = withUrls(data.tasks ?? (Array.isArray(data) ? data : []));
       return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
     }
 
     if (name === "get_task") {
       const id = String(args?.id ?? "");
-      const data = await apiGet<unknown>(`/api/tasks/${id}`);
-      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+      const data = await apiGet<TaskLike>(`/api/tasks/${id}`);
+      return { content: [{ type: "text", text: JSON.stringify(withUrl(data), null, 2) }] };
     }
 
     if (name === "search_tasks") {
       const query = String(args?.query ?? "");
       const limit = args?.limit ? String(args.limit) : "10";
-      const data = await apiGet<unknown>("/api/tasks/search", { q: query, limit });
-      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+      const data = await apiGet<{ tasks?: unknown[] }>("/api/tasks/search", { q: query, limit });
+      const tasks = withUrls(data.tasks ?? (Array.isArray(data) ? data : []));
+      return { content: [{ type: "text", text: JSON.stringify(tasks, null, 2) }] };
+    }
+
+    if (name === "find_employee") {
+      const query = String(args?.name ?? "").toLowerCase().trim();
+      if (!query) return { content: [{ type: "text", text: "Ошибка: name обязателен" }] };
+      const data = await apiGet<{ employees?: Array<{ id: string; displayName?: string; email?: string; slackUserId?: string }> }>("/api/registry");
+      const employees = data.employees ?? [];
+      const found = employees.filter((e) => {
+        const name = (e.displayName ?? "").toLowerCase();
+        const email = (e.email ?? "").toLowerCase();
+        return name.includes(query) || email.includes(query);
+      });
+      if (!found.length) return { content: [{ type: "text", text: `Сотрудник «${args?.name}» не найден` }] };
+      const result = found.map((e) => ({ id: e.id, displayName: e.displayName, email: e.email, profileUrl: `${BASE_URL}/#/team/${e.id}` }));
+      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     }
 
     if (name === "propose_task_change") {
@@ -267,12 +309,17 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       if (args?.limit) params.limit = String(args.limit);
       if (args?.offset) params.offset = String(args.offset);
       const data = await apiGet<{ tasks?: unknown[]; total?: number }>("/api/tasks/team", params);
-      const tasks = data.tasks ?? [];
+      const tasks = withUrls(data.tasks ?? []).map((t) => {
+        if (typeof t.assigneeId === "string") {
+          return { ...t, assigneeUrl: `${BASE_URL}/#/team/${t.assigneeId}` };
+        }
+        return t;
+      });
       const total = data.total ?? tasks.length;
       return {
         content: [{
           type: "text",
-          text: `Найдено задач: ${total}\n\n${JSON.stringify(tasks, null, 2)}`,
+          text: `Найдено задач: ${total}\n\nПри отображении форматируй названия задач как markdown-ссылки [название](url), имена исполнителей — как [имя](assigneeUrl).\n\n${JSON.stringify(tasks, null, 2)}`,
         }],
       };
     }
@@ -310,7 +357,16 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       const inProgress = filtered.filter((t) => t.status === "open" && t.dueDate && t.dueDate >= today);
 
       const fmt = (list: typeof filtered) =>
-        list.map((t) => `  • ${t.title} (срок: ${t.dueDate ?? "—"}${t.completedAt ? `, выполнена: ${t.completedAt.slice(0, 10)}` : ""}${t.projectName ? `, проект: ${t.projectName}` : ""})`).join("\n");
+        list.map((t) => {
+          const taskUrl = `${BASE_URL}/#/tasks/${t.id}`;
+          const assigneePart = t.assigneeName
+            ? `, [${t.assigneeName}](${BASE_URL}/#/team/${assigneeId})`
+            : "";
+          const parts = [`срок: ${t.dueDate ?? "—"}`];
+          if (t.completedAt) parts.push(`выполнена: ${t.completedAt.slice(0, 10)}`);
+          if (t.projectName) parts.push(`проект: ${t.projectName}`);
+          return `  • [${t.title}](${taskUrl}) (${parts.join(", ")}${assigneePart})`;
+        }).join("\n");
 
       const period = dateFrom || dateTo ? ` (период: ${dateFrom ?? "..."} — ${dateTo ?? "..."})` : "";
       const lines = [
@@ -340,5 +396,69 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
   }
 });
 
+const PROMPTS = [
+  {
+    name: "задачи-сегодня",
+    description: "Что у меня запланировано на сегодня",
+    arguments: [],
+  },
+  {
+    name: "что-просрочено",
+    description: "Мои просроченные задачи и дедлайны",
+    arguments: [],
+  },
+  {
+    name: "создать-задачу",
+    description: "Создать новую задачу",
+    arguments: [{ name: "описание", description: "Что нужно сделать", required: true }],
+  },
+  {
+    name: "отчёт-сотрудника",
+    description: "Отчёт по задачам сотрудника за период (для руководителей)",
+    arguments: [
+      { name: "сотрудник", description: "Имя или email сотрудника", required: true },
+      { name: "период", description: "Например: июнь 2026 или 2026-06-01 / 2026-06-30", required: false },
+    ],
+  },
+  {
+    name: "найти-задачу",
+    description: "Найти задачу по теме или ключевым словам",
+    arguments: [{ name: "тема", description: "Что искать", required: true }],
+  },
+] as const;
+
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+  prompts: PROMPTS.map(({ name, description, arguments: args }) => ({
+    name,
+    description,
+    arguments: (args as unknown) as { name: string; description: string; required: boolean }[],
+  })),
+}));
+
+server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+  const { name, arguments: promptArgs } = req.params;
+  const messages: { role: "user"; content: { type: "text"; text: string } }[] = [];
+
+  if (name === "задачи-сегодня") {
+    messages.push({ role: "user", content: { type: "text", text: "Покажи мои задачи на сегодня" } });
+  } else if (name === "что-просрочено") {
+    messages.push({ role: "user", content: { type: "text", text: "Что у меня просрочено? Покажи задачи с прошедшим дедлайном" } });
+  } else if (name === "создать-задачу") {
+    const desc = promptArgs?.["описание"] ?? "...";
+    messages.push({ role: "user", content: { type: "text", text: `Создай задачу: ${desc}` } });
+  } else if (name === "отчёт-сотрудника") {
+    const emp = promptArgs?.["сотрудник"] ?? "...";
+    const period = promptArgs?.["период"] ? ` за ${promptArgs["период"]}` : "";
+    messages.push({ role: "user", content: { type: "text", text: `Сначала найди сотрудника «${emp}» через find_employee, затем сделай отчёт по его задачам${period}: что просрочено, что выполнено вовремя, что в работе` } });
+  } else if (name === "найти-задачу") {
+    const topic = promptArgs?.["тема"] ?? "...";
+    messages.push({ role: "user", content: { type: "text", text: `Найди задачи по теме: ${topic}` } });
+  } else {
+    messages.push({ role: "user", content: { type: "text", text: name } });
+  }
+
+  return { messages };
+});
+
 const transport = new StdioServerTransport();
 await server.connect(transport);