senq-mcp 1.0.0

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+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

@@ -0,0 +1,63 @@
+const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
+function getApiKey() {
+    const key = process.env.SENQ_API_KEY ?? "";
+    if (!key) {
+        console.error("[senq-mcp] SENQ_API_KEY is not set. Run: npx senq-mcp setup");
+        process.exit(1);
+    }
+    return key;
+}
+function getViewer() {
+    return process.env.SENQ_VIEWER ?? "";
+}
+export async function apiGet(path, params) {
+    const API_KEY = getApiKey();
+    const VIEWER = getViewer();
+    const url = new URL(BASE_URL + path);
+    if (VIEWER)
+        url.searchParams.set("viewer", VIEWER);
+    if (params)
+        Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+    const res = await fetch(url.toString(), {
+        headers: { Authorization: `Bearer ${API_KEY}` },
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+export async function apiPost(path, body) {
+    const API_KEY = getApiKey();
+    const VIEWER = getViewer();
+    const url = new URL(BASE_URL + path);
+    if (VIEWER)
+        url.searchParams.set("viewer", VIEWER);
+    const res = await fetch(url.toString(), {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+export async function apiPatch(path, body) {
+    const API_KEY = getApiKey();
+    const VIEWER = getViewer();
+    const url = new URL(BASE_URL + path);
+    if (VIEWER)
+        url.searchParams.set("viewer", VIEWER);
+    const res = await fetch(url.toString(), {
+        method: "PATCH",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,248 @@
+#!/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 { 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.0.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "list_tasks",
+            description: "Список задач пользователя. Без параметров — задачи на сегодня.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    list: { type: "string", enum: ["today", "personal", "plans", "someday", "completed"], description: "Тип списка" },
+                    projectId: { type: "string", description: "ID проекта" },
+                    status: { type: "string", enum: ["open", "completed"] },
+                    limit: { type: "number", description: "Макс. количество (по умолчанию 20)" },
+                },
+            },
+        },
+        {
+            name: "get_task",
+            description: "Получить задачу по ID с деталями, комментариями и подзадачами.",
+            inputSchema: {
+                type: "object",
+                required: ["id"],
+                properties: {
+                    id: { type: "string", description: "ID задачи" },
+                },
+            },
+        },
+        {
+            name: "search_tasks",
+            description: "Поиск задач по тексту заголовка.",
+            inputSchema: {
+                type: "object",
+                required: ["query"],
+                properties: {
+                    query: { type: "string", description: "Поисковый запрос" },
+                    limit: { type: "number" },
+                },
+            },
+        },
+        {
+            name: "propose_task_change",
+            description: "Предложить создание или изменение задачи. Возвращает preview и токен для подтверждения — не пишет сразу.",
+            inputSchema: {
+                type: "object",
+                required: ["action"],
+                properties: {
+                    action: { type: "string", enum: ["create", "update"], description: "Действие" },
+                    taskId: { type: "string", description: "ID задачи (для action=update)" },
+                    title: { type: "string" },
+                    descriptionHtml: { type: "string" },
+                    dueDate: { type: "string", description: "YYYY-MM-DD" },
+                    status: { type: "string", enum: ["open", "completed"] },
+                    projectId: { type: "string" },
+                    todayDate: { type: "string", description: "YYYY-MM-DD — поставить в «Сегодня»" },
+                    priority: { type: "number", description: "0–3 (0 = нет, 3 = высокий)" },
+                },
+            },
+        },
+        {
+            name: "confirm_task_change",
+            description: "Выполнить изменение задачи, подтверждённое пользователем. Передай токен из propose_task_change.",
+            inputSchema: {
+                type: "object",
+                required: ["token"],
+                properties: {
+                    token: { type: "string", description: "Токен из propose_task_change" },
+                },
+            },
+        },
+        {
+            name: "list_projects",
+            description: "Список проектов доступных пользователю.",
+            inputSchema: { type: "object", properties: {} },
+        },
+        {
+            name: "search_knowledge",
+            description: "Поиск по базе знаний.",
+            inputSchema: {
+                type: "object",
+                required: ["query"],
+                properties: {
+                    query: { type: "string" },
+                    limit: { type: "number" },
+                },
+            },
+        },
+        {
+            name: "get_analytics",
+            description: "Аналитика по задачам пользователя. Типы: summary (итоги), stuck (застрявшие), deadline_risk (дедлайны).",
+            inputSchema: {
+                type: "object",
+                required: ["type"],
+                properties: {
+                    type: { type: "string", enum: ["summary", "stuck", "deadline_risk"] },
+                },
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    try {
+        if (name === "list_tasks") {
+            const params = {};
+            if (args?.list)
+                params.list = String(args.list);
+            else
+                params.list = "today";
+            if (args?.projectId)
+                params.projectId = String(args.projectId);
+            if (args?.status)
+                params.status = String(args.status);
+            if (args?.limit)
+                params.limit = String(args.limit);
+            const data = await apiGet("/api/tasks", params);
+            const tasks = 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) }] };
+        }
+        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) }] };
+        }
+        if (name === "propose_task_change") {
+            const action = String(args?.action ?? "create");
+            const payload = {};
+            const previewParts = [];
+            if (action === "create") {
+                if (!args?.title)
+                    return { content: [{ type: "text", text: "Ошибка: title обязателен для создания задачи" }] };
+                payload.title = args.title;
+                previewParts.push(`Создать задачу: «${args.title}»`);
+                if (args?.dueDate) {
+                    payload.dueDate = args.dueDate;
+                    previewParts.push(`Срок: ${args.dueDate}`);
+                }
+                if (args?.projectId) {
+                    payload.projectId = args.projectId;
+                    previewParts.push(`Проект: ${args.projectId}`);
+                }
+                if (args?.todayDate) {
+                    payload.todayDate = args.todayDate;
+                    previewParts.push(`В «Сегодня»: ${args.todayDate}`);
+                }
+                if (args?.priority) {
+                    payload.priority = args.priority;
+                    previewParts.push(`Приоритет: ${args.priority}`);
+                }
+                if (args?.descriptionHtml)
+                    payload.descriptionHtml = args.descriptionHtml;
+            }
+            else {
+                const taskId = String(args?.taskId ?? "");
+                if (!taskId)
+                    return { content: [{ type: "text", text: "Ошибка: taskId обязателен для обновления" }] };
+                payload.taskId = taskId;
+                previewParts.push(`Изменить задачу ${taskId}`);
+                if (args?.title !== undefined) {
+                    payload.title = args.title;
+                    previewParts.push(`Новый заголовок: «${args.title}»`);
+                }
+                if (args?.status) {
+                    payload.status = args.status;
+                    previewParts.push(`Статус: ${args.status}`);
+                }
+                if (args?.dueDate !== undefined) {
+                    payload.dueDate = args.dueDate;
+                    previewParts.push(`Срок: ${args.dueDate ?? "убрать"}`);
+                }
+                if (args?.todayDate !== undefined) {
+                    payload.todayDate = args.todayDate;
+                }
+                if (args?.priority !== undefined) {
+                    payload.priority = args.priority;
+                }
+            }
+            const token = storePending({ type: action === "create" ? "create_task" : "update_task", payload, preview: previewParts.join(", ") });
+            return {
+                content: [{
+                        type: "text",
+                        text: `📋 Preview: ${previewParts.join(" | ")}\n\nЧтобы применить, вызови confirm_task_change с токеном: ${token}\nТокен действителен 5 минут.`,
+                    }],
+            };
+        }
+        if (name === "confirm_task_change") {
+            const token = String(args?.token ?? "");
+            const change = consumePending(token);
+            if (!change)
+                return { content: [{ type: "text", text: "Токен не найден или истёк. Попроси новый preview." }] };
+            let result;
+            if (change.type === "create_task") {
+                result = await apiPost("/api/tasks", change.payload);
+            }
+            else {
+                const { taskId, ...rest } = change.payload;
+                result = await apiPatch(`/api/tasks/${taskId}`, rest);
+            }
+            return { content: [{ type: "text", text: `✅ Готово: ${change.preview}\n\n${JSON.stringify(result, null, 2)}` }] };
+        }
+        if (name === "list_projects") {
+            const data = await apiGet("/api/registry");
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        if (name === "search_knowledge") {
+            const query = String(args?.query ?? "");
+            const limit = args?.limit ? String(args.limit) : "8";
+            const data = await apiGet("/api/knowledge/search", { q: query, limit });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        if (name === "get_analytics") {
+            const type = String(args?.type ?? "summary");
+            const pathMap = {
+                summary: "/api/analytics/summary",
+                stuck: "/api/analytics/stuck-tasks",
+                deadline_risk: "/api/analytics/deadline-risk",
+            };
+            const apiPath = pathMap[type];
+            if (!apiPath)
+                return { content: [{ type: "text", text: `Неизвестный тип: ${type}` }] };
+            const data = await apiGet(apiPath);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        return { content: [{ type: "text", text: `Неизвестный инструмент: ${name}` }] };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Ошибка: ${msg}` }], isError: true };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/pending-changes.d.ts

@@ -0,0 +1,9 @@
+type PendingChange = {
+    type: "create_task" | "update_task";
+    payload: Record<string, unknown>;
+    preview: string;
+    expiresAt: number;
+};
+export declare function storePending(change: Omit<PendingChange, "expiresAt">): string;
+export declare function consumePending(token: string): PendingChange | null;
+export {};

package/dist/pending-changes.js

@@ -0,0 +1,24 @@
+import { randomUUID } from "node:crypto";
+const store = new Map();
+export function storePending(change) {
+    const token = randomUUID();
+    store.set(token, { ...change, expiresAt: Date.now() + 5 * 60 * 1000 });
+    return token;
+}
+export function consumePending(token) {
+    const change = store.get(token);
+    if (!change)
+        return null;
+    if (change.expiresAt < Date.now()) {
+        store.delete(token);
+        return null;
+    }
+    store.delete(token);
+    return change;
+}
+setInterval(() => {
+    const now = Date.now();
+    for (const [k, v] of store)
+        if (v.expiresAt < now)
+            store.delete(k);
+}, 60_000);

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,124 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as readline from "readline";
+function getConfigPath(client) {
+    const home = os.homedir();
+    switch (client) {
+        case "claude":
+            if (process.platform === "win32")
+                return path.join(process.env.APPDATA ?? home, "Claude", "claude_desktop_config.json");
+            if (process.platform === "linux")
+                return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+            return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+        case "cursor":
+            return path.join(home, ".cursor", "mcp.json");
+        case "claudecode":
+            return path.join(home, ".claude.json");
+        default:
+            return "";
+    }
+}
+const CLIENTS = [
+    { id: "claude", label: "Claude Desktop", configPath: getConfigPath("claude") },
+    { id: "cursor", label: "Cursor", configPath: getConfigPath("cursor") },
+    { id: "claudecode", label: "Claude Code", configPath: getConfigPath("claudecode") },
+];
+function readHidden(prompt) {
+    return new Promise((resolve) => {
+        process.stdout.write(prompt);
+        if (!process.stdin.isTTY) {
+            const rl = readline.createInterface({ input: process.stdin });
+            rl.once("line", (line) => { rl.close(); resolve(line.trim()); });
+            return;
+        }
+        const chars = [];
+        const onData = (buf) => {
+            const char = buf.toString("utf8");
+            if (char === "\n" || char === "\r" || char === "") {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeListener("data", onData);
+                process.stdout.write("\n");
+                resolve(chars.join(""));
+            }
+            else if (char === "") {
+                process.stdout.write("\n");
+                process.exit(0);
+            }
+            else if (char === "" || char === "\b") {
+                if (chars.length > 0) {
+                    chars.pop();
+                    process.stdout.write("\b \b");
+                }
+            }
+            else {
+                chars.push(char);
+                process.stdout.write("*");
+            }
+        };
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.on("data", onData);
+    });
+}
+function ask(question, defaultVal = "") {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, (answer) => { rl.close(); resolve(answer.trim() || defaultVal); });
+    });
+}
+function mergeConfig(configPath, apiKey) {
+    let config = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        }
+        catch { /* corrupt — start fresh */ }
+    }
+    const mcpServers = config["mcpServers"] ?? {};
+    mcpServers["senq"] = { command: "npx", args: ["senq-mcp"], env: { SENQ_API_KEY: apiKey } };
+    config["mcpServers"] = mcpServers;
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+export async function runSetup() {
+    console.log("\n🤖 Настройка Senq MCP\n");
+    const apiKey = await readHidden("Вставь API-ключ из Senq: ");
+    if (!apiKey.startsWith("sk-senq-")) {
+        console.error("\n❌ Ключ должен начинаться с sk-senq-.\n   Получи ключ в настройках Senq → API-ключи.\n");
+        process.exit(1);
+    }
+    console.log("\nДля какого клиента настроить?\n");
+    CLIENTS.forEach((c, i) => {
+        const exists = fs.existsSync(c.configPath);
+        console.log(`  ${i + 1}) ${c.label}${exists ? "  (конфиг найден)" : ""}`);
+    });
+    console.log(`  ${CLIENTS.length + 1}) Все три\n`);
+    const choice = await ask("Введи номер [1]: ", "1");
+    const num = parseInt(choice, 10);
+    let selected;
+    if (num === CLIENTS.length + 1) {
+        selected = CLIENTS;
+    }
+    else if (num >= 1 && num <= CLIENTS.length) {
+        selected = [CLIENTS[num - 1]];
+    }
+    else {
+        selected = [CLIENTS[0]];
+    }
+    console.log("");
+    for (const client of selected) {
+        try {
+            mergeConfig(client.configPath, apiKey);
+            console.log(`  ✅ ${client.label}:  ${client.configPath}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(`  ❌ ${client.label}: ${msg}`);
+        }
+    }
+    const names = selected.map((c) => c.label).join(" и ");
+    console.log(`\n🎉 Готово! Перезапусти ${names}.\n`);
+    console.log("   Затем спроси: «Покажи мои задачи на сегодня»\n");
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "senq-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Senq — connect your AI to tasks and knowledge",
+  "type": "module",
+  "bin": {
+    "senq-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  }
+}

package/src/client.ts

@@ -0,0 +1,61 @@
+const BASE_URL = (process.env.SENQ_BASE_URL ?? "https://senq.serenity.agency").replace(/\/$/, "");
+
+function getApiKey(): string {
+  const key = process.env.SENQ_API_KEY ?? "";
+  if (!key) {
+    console.error("[senq-mcp] SENQ_API_KEY is not set. Run: npx senq-mcp setup");
+    process.exit(1);
+  }
+  return key;
+}
+
+function getViewer(): string {
+  return process.env.SENQ_VIEWER ?? "";
+}
+
+export async function apiGet<T>(path: string, params?: Record<string, string>): Promise<T> {
+  const API_KEY = getApiKey();
+  const VIEWER = getViewer();
+  const url = new URL(BASE_URL + path);
+  if (VIEWER) url.searchParams.set("viewer", VIEWER);
+  if (params) Object.entries(params).forEach(([k, v]) => url.searchParams.set(k, v));
+  const res = await fetch(url.toString(), {
+    headers: { Authorization: `Bearer ${API_KEY}` },
+  });
+  if (!res.ok) throw new Error(`API ${res.status}: ${await res.text()}`);
+  return res.json() as Promise<T>;
+}
+
+export async function apiPost<T>(path: string, body: unknown): Promise<T> {
+  const API_KEY = getApiKey();
+  const VIEWER = getViewer();
+  const url = new URL(BASE_URL + path);
+  if (VIEWER) url.searchParams.set("viewer", VIEWER);
+  const res = await fetch(url.toString(), {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) throw new Error(`API ${res.status}: ${await res.text()}`);
+  return res.json() as Promise<T>;
+}
+
+export async function apiPatch<T>(path: string, body: unknown): Promise<T> {
+  const API_KEY = getApiKey();
+  const VIEWER = getViewer();
+  const url = new URL(BASE_URL + path);
+  if (VIEWER) url.searchParams.set("viewer", VIEWER);
+  const res = await fetch(url.toString(), {
+    method: "PATCH",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify(body),
+  });
+  if (!res.ok) throw new Error(`API ${res.status}: ${await res.text()}`);
+  return res.json() as Promise<T>;
+}

package/src/index.ts

@@ -0,0 +1,233 @@
+#!/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 { 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.0.0" },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "list_tasks",
+      description: "Список задач пользователя. Без параметров — задачи на сегодня.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          list: { type: "string", enum: ["today", "personal", "plans", "someday", "completed"], description: "Тип списка" },
+          projectId: { type: "string", description: "ID проекта" },
+          status: { type: "string", enum: ["open", "completed"] },
+          limit: { type: "number", description: "Макс. количество (по умолчанию 20)" },
+        },
+      },
+    },
+    {
+      name: "get_task",
+      description: "Получить задачу по ID с деталями, комментариями и подзадачами.",
+      inputSchema: {
+        type: "object",
+        required: ["id"],
+        properties: {
+          id: { type: "string", description: "ID задачи" },
+        },
+      },
+    },
+    {
+      name: "search_tasks",
+      description: "Поиск задач по тексту заголовка.",
+      inputSchema: {
+        type: "object",
+        required: ["query"],
+        properties: {
+          query: { type: "string", description: "Поисковый запрос" },
+          limit: { type: "number" },
+        },
+      },
+    },
+    {
+      name: "propose_task_change",
+      description: "Предложить создание или изменение задачи. Возвращает preview и токен для подтверждения — не пишет сразу.",
+      inputSchema: {
+        type: "object",
+        required: ["action"],
+        properties: {
+          action: { type: "string", enum: ["create", "update"], description: "Действие" },
+          taskId: { type: "string", description: "ID задачи (для action=update)" },
+          title: { type: "string" },
+          descriptionHtml: { type: "string" },
+          dueDate: { type: "string", description: "YYYY-MM-DD" },
+          status: { type: "string", enum: ["open", "completed"] },
+          projectId: { type: "string" },
+          todayDate: { type: "string", description: "YYYY-MM-DD — поставить в «Сегодня»" },
+          priority: { type: "number", description: "0–3 (0 = нет, 3 = высокий)" },
+        },
+      },
+    },
+    {
+      name: "confirm_task_change",
+      description: "Выполнить изменение задачи, подтверждённое пользователем. Передай токен из propose_task_change.",
+      inputSchema: {
+        type: "object",
+        required: ["token"],
+        properties: {
+          token: { type: "string", description: "Токен из propose_task_change" },
+        },
+      },
+    },
+    {
+      name: "list_projects",
+      description: "Список проектов доступных пользователю.",
+      inputSchema: { type: "object", properties: {} },
+    },
+    {
+      name: "search_knowledge",
+      description: "Поиск по базе знаний.",
+      inputSchema: {
+        type: "object",
+        required: ["query"],
+        properties: {
+          query: { type: "string" },
+          limit: { type: "number" },
+        },
+      },
+    },
+    {
+      name: "get_analytics",
+      description: "Аналитика по задачам пользователя. Типы: summary (итоги), stuck (застрявшие), deadline_risk (дедлайны).",
+      inputSchema: {
+        type: "object",
+        required: ["type"],
+        properties: {
+          type: { type: "string", enum: ["summary", "stuck", "deadline_risk"] },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const { name, arguments: args } = req.params;
+
+  try {
+    if (name === "list_tasks") {
+      const params: Record<string, string> = {};
+      if (args?.list) params.list = String(args.list);
+      else params.list = "today";
+      if (args?.projectId) params.projectId = String(args.projectId);
+      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 : []);
+      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) }] };
+    }
+
+    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) }] };
+    }
+
+    if (name === "propose_task_change") {
+      const action = String(args?.action ?? "create");
+      const payload: Record<string, unknown> = {};
+      const previewParts: string[] = [];
+
+      if (action === "create") {
+        if (!args?.title) return { content: [{ type: "text", text: "Ошибка: title обязателен для создания задачи" }] };
+        payload.title = args.title;
+        previewParts.push(`Создать задачу: «${args.title}»`);
+        if (args?.dueDate) { payload.dueDate = args.dueDate; previewParts.push(`Срок: ${args.dueDate}`); }
+        if (args?.projectId) { payload.projectId = args.projectId; previewParts.push(`Проект: ${args.projectId}`); }
+        if (args?.todayDate) { payload.todayDate = args.todayDate; previewParts.push(`В «Сегодня»: ${args.todayDate}`); }
+        if (args?.priority) { payload.priority = args.priority; previewParts.push(`Приоритет: ${args.priority}`); }
+        if (args?.descriptionHtml) payload.descriptionHtml = args.descriptionHtml;
+      } else {
+        const taskId = String(args?.taskId ?? "");
+        if (!taskId) return { content: [{ type: "text", text: "Ошибка: taskId обязателен для обновления" }] };
+        payload.taskId = taskId;
+        previewParts.push(`Изменить задачу ${taskId}`);
+        if (args?.title !== undefined) { payload.title = args.title; previewParts.push(`Новый заголовок: «${args.title}»`); }
+        if (args?.status) { payload.status = args.status; previewParts.push(`Статус: ${args.status}`); }
+        if (args?.dueDate !== undefined) { payload.dueDate = args.dueDate; previewParts.push(`Срок: ${args.dueDate ?? "убрать"}`); }
+        if (args?.todayDate !== undefined) { payload.todayDate = args.todayDate; }
+        if (args?.priority !== undefined) { payload.priority = args.priority; }
+      }
+
+      const token = storePending({ type: action === "create" ? "create_task" : "update_task", payload, preview: previewParts.join(", ") });
+      return {
+        content: [{
+          type: "text",
+          text: `📋 Preview: ${previewParts.join(" | ")}\n\nЧтобы применить, вызови confirm_task_change с токеном: ${token}\nТокен действителен 5 минут.`,
+        }],
+      };
+    }
+
+    if (name === "confirm_task_change") {
+      const token = String(args?.token ?? "");
+      const change = consumePending(token);
+      if (!change) return { content: [{ type: "text", text: "Токен не найден или истёк. Попроси новый preview." }] };
+
+      let result: unknown;
+      if (change.type === "create_task") {
+        result = await apiPost<unknown>("/api/tasks", change.payload);
+      } else {
+        const { taskId, ...rest } = change.payload;
+        result = await apiPatch<unknown>(`/api/tasks/${taskId}`, rest);
+      }
+      return { content: [{ type: "text", text: `✅ Готово: ${change.preview}\n\n${JSON.stringify(result, null, 2)}` }] };
+    }
+
+    if (name === "list_projects") {
+      const data = await apiGet<unknown>("/api/registry");
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+
+    if (name === "search_knowledge") {
+      const query = String(args?.query ?? "");
+      const limit = args?.limit ? String(args.limit) : "8";
+      const data = await apiGet<unknown>("/api/knowledge/search", { q: query, limit });
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+
+    if (name === "get_analytics") {
+      const type = String(args?.type ?? "summary");
+      const pathMap: Record<string, string> = {
+        summary: "/api/analytics/summary",
+        stuck: "/api/analytics/stuck-tasks",
+        deadline_risk: "/api/analytics/deadline-risk",
+      };
+      const apiPath = pathMap[type];
+      if (!apiPath) return { content: [{ type: "text", text: `Неизвестный тип: ${type}` }] };
+      const data = await apiGet<unknown>(apiPath);
+      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    }
+
+    return { content: [{ type: "text", text: `Неизвестный инструмент: ${name}` }] };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: `Ошибка: ${msg}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/src/pending-changes.ts

@@ -0,0 +1,29 @@
+import { randomUUID } from "node:crypto";
+
+type PendingChange = {
+  type: "create_task" | "update_task";
+  payload: Record<string, unknown>;
+  preview: string;
+  expiresAt: number;
+};
+
+const store = new Map<string, PendingChange>();
+
+export function storePending(change: Omit<PendingChange, "expiresAt">): string {
+  const token = randomUUID();
+  store.set(token, { ...change, expiresAt: Date.now() + 5 * 60 * 1000 });
+  return token;
+}
+
+export function consumePending(token: string): PendingChange | null {
+  const change = store.get(token);
+  if (!change) return null;
+  if (change.expiresAt < Date.now()) { store.delete(token); return null; }
+  store.delete(token);
+  return change;
+}
+
+setInterval(() => {
+  const now = Date.now();
+  for (const [k, v] of store) if (v.expiresAt < now) store.delete(k);
+}, 60_000);

package/src/setup.ts

@@ -0,0 +1,133 @@
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import * as readline from "readline";
+
+interface ClientInfo {
+  id: string;
+  label: string;
+  configPath: string;
+}
+
+function getConfigPath(client: string): string {
+  const home = os.homedir();
+  switch (client) {
+    case "claude":
+      if (process.platform === "win32")
+        return path.join(process.env.APPDATA ?? home, "Claude", "claude_desktop_config.json");
+      if (process.platform === "linux")
+        return path.join(home, ".config", "Claude", "claude_desktop_config.json");
+      return path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    case "cursor":
+      return path.join(home, ".cursor", "mcp.json");
+    case "claudecode":
+      return path.join(home, ".claude.json");
+    default:
+      return "";
+  }
+}
+
+const CLIENTS: ClientInfo[] = [
+  { id: "claude",     label: "Claude Desktop", configPath: getConfigPath("claude") },
+  { id: "cursor",     label: "Cursor",          configPath: getConfigPath("cursor") },
+  { id: "claudecode", label: "Claude Code",     configPath: getConfigPath("claudecode") },
+];
+
+function readHidden(prompt: string): Promise<string> {
+  return new Promise((resolve) => {
+    process.stdout.write(prompt);
+
+    if (!process.stdin.isTTY) {
+      const rl = readline.createInterface({ input: process.stdin });
+      rl.once("line", (line) => { rl.close(); resolve(line.trim()); });
+      return;
+    }
+
+    const chars: string[] = [];
+    const onData = (buf: Buffer) => {
+      const char = buf.toString("utf8");
+      if (char === "\n" || char === "\r" || char === "") {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdin.removeListener("data", onData);
+        process.stdout.write("\n");
+        resolve(chars.join(""));
+      } else if (char === "") {
+        process.stdout.write("\n");
+        process.exit(0);
+      } else if (char === "" || char === "\b") {
+        if (chars.length > 0) { chars.pop(); process.stdout.write("\b \b"); }
+      } else {
+        chars.push(char);
+        process.stdout.write("*");
+      }
+    };
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+  });
+}
+
+function ask(question: string, defaultVal = ""): Promise<string> {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => { rl.close(); resolve(answer.trim() || defaultVal); });
+  });
+}
+
+function mergeConfig(configPath: string, apiKey: string): void {
+  let config: Record<string, unknown> = {};
+  if (fs.existsSync(configPath)) {
+    try { config = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch { /* corrupt — start fresh */ }
+  }
+  const mcpServers = (config["mcpServers"] as Record<string, unknown>) ?? {};
+  mcpServers["senq"] = { command: "npx", args: ["senq-mcp"], env: { SENQ_API_KEY: apiKey } };
+  config["mcpServers"] = mcpServers;
+  fs.mkdirSync(path.dirname(configPath), { recursive: true });
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n");
+}
+
+export async function runSetup(): Promise<void> {
+  console.log("\n🤖 Настройка Senq MCP\n");
+
+  const apiKey = await readHidden("Вставь API-ключ из Senq: ");
+
+  if (!apiKey.startsWith("sk-senq-")) {
+    console.error("\n❌ Ключ должен начинаться с sk-senq-.\n   Получи ключ в настройках Senq → API-ключи.\n");
+    process.exit(1);
+  }
+
+  console.log("\nДля какого клиента настроить?\n");
+  CLIENTS.forEach((c, i) => {
+    const exists = fs.existsSync(c.configPath);
+    console.log(`  ${i + 1}) ${c.label}${exists ? "  (конфиг найден)" : ""}`);
+  });
+  console.log(`  ${CLIENTS.length + 1}) Все три\n`);
+
+  const choice = await ask("Введи номер [1]: ", "1");
+  const num = parseInt(choice, 10);
+
+  let selected: ClientInfo[];
+  if (num === CLIENTS.length + 1) {
+    selected = CLIENTS;
+  } else if (num >= 1 && num <= CLIENTS.length) {
+    selected = [CLIENTS[num - 1]];
+  } else {
+    selected = [CLIENTS[0]];
+  }
+
+  console.log("");
+  for (const client of selected) {
+    try {
+      mergeConfig(client.configPath, apiKey);
+      console.log(`  ✅ ${client.label}:  ${client.configPath}`);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(`  ❌ ${client.label}: ${msg}`);
+    }
+  }
+
+  const names = selected.map((c) => c.label).join(" и ");
+  console.log(`\n🎉 Готово! Перезапусти ${names}.\n`);
+  console.log("   Затем спроси: «Покажи мои задачи на сегодня»\n");
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true
+  },
+  "include": ["src"]
+}