@naparnik/mcp 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { NaparnikConfigError, loadConfig, NaparnikApiClient, McpServer, createNaparnikTools, StdioServerTransport } from './chunk-T6UWKM37.js';
+
+// src/cli.ts
+function log(message) {
+  process.stderr.write(`[naparnik-mcp] ${message}
+`);
+}
+async function main() {
+  const config = loadConfig();
+  const client = new NaparnikApiClient(config);
+  const server = new McpServer();
+  const tools = createNaparnikTools(client);
+  for (const tool of tools) server.addTool(tool);
+  const transport = new StdioServerTransport();
+  transport.onClose((error) => {
+    if (error !== void 0) log(`\u0441\u043E\u0435\u0434\u0438\u043D\u0435\u043D\u0438\u0435 \u0437\u0430\u043A\u0440\u044B\u0442\u043E \u0441 \u043E\u0448\u0438\u0431\u043A\u043E\u0439: ${error.message}`);
+    process.exit(error !== void 0 ? 1 : 0);
+  });
+  await transport.connect();
+  await server.start(transport);
+  log(`\u043F\u043E\u0434\u043A\u043B\u044E\u0447\u0451\u043D \u043A ${config.baseUrl}, \u0438\u043D\u0441\u0442\u0440\u0443\u043C\u0435\u043D\u0442\u043E\u0432: ${tools.length}`);
+  for (const signal of ["SIGINT", "SIGTERM"]) {
+    process.on(signal, () => {
+      void server.stop().finally(() => process.exit(0));
+    });
+  }
+}
+main().catch((err) => {
+  if (err instanceof NaparnikConfigError) {
+    log(err.message);
+    process.exit(1);
+  }
+  log(`\u043D\u0435 \u0443\u0434\u0430\u043B\u043E\u0441\u044C \u0437\u0430\u043F\u0443\u0441\u0442\u0438\u0442\u044C\u0441\u044F: ${err instanceof Error ? err.message : String(err)}`);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+import { Tool } from '@naparnik/super-agent-core/mcp';
+
+interface NaparnikMcpConfig {
+    apiKey: string;
+    baseUrl: string;
+    timeoutMs: number;
+    longTimeoutMs: number;
+}
+/**
+ * Собирает конфиг из переменных окружения, которые Claude передаёт процессу
+ * из блока `env` в своём конфиге.
+ *
+ * Сообщения об ошибках рассчитаны на человека, который видит их в диагностике
+ * Claude и не читал нашу документацию: они говорят, что именно не так и куда
+ * идти за ключом.
+ */
+declare function loadConfig(env?: NodeJS.ProcessEnv): NaparnikMcpConfig;
+
+declare class NaparnikApiClient {
+    private readonly config;
+    constructor(config: NaparnikMcpConfig);
+    /**
+     * POST к sdk-эндпоинту. Все automation-эндпоинты только POST — таково
+     * ограничение VerbFilter на сервере, отдельного GET-пути нет.
+     *
+     * @param path путь относительно /api/internal/automation/sdk
+     * @param body тело запроса
+     * @param opts long: использовать увеличенный таймаут (генерация, поиск)
+     */
+    post<T>(path: string, body?: unknown, opts?: {
+        long?: boolean;
+    }): Promise<T>;
+    private attempt;
+    private parse;
+}
+
+declare function createNaparnikTools(client: NaparnikApiClient): Tool[];
+
+/**
+ * Иерархия ошибок клиента Напарника.
+ *
+ * Порт модели ошибок Python SDK (`shared/python-sdk/runtime/naparnik_sdk/`),
+ * которая проверена в бою на pipeline-скриптах. Главное в ней — разделение
+ * «ретрай поможет» / «ретрай бесполезен»: без него клиент, упёршийся в нехватку
+ * прав, добросовестно долбит эндпоинт с backoff'ом, пока не упрётся в лимиты.
+ *
+ * Отдельно от Python-версии здесь выделена нехватка средств: у внешнего клиента
+ * нет нашего UI, поэтому ошибка обязана нести ссылку и сумму, а не только текст.
+ */
+/** Базовая ошибка обращения к API Напарника. */
+declare class NaparnikError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+    /**
+     * Имеет ли смысл повторять запрос. По умолчанию нет: повтор — осознанное
+     * решение для конкретных подклассов, а не поведение по умолчанию.
+     */
+    get retryable(): boolean;
+}
+/** 401 — ключ не признан: не тот формат, отозван, истёк. */
+declare class NaparnikAuthError extends NaparnikError {
+}
+/** 403 — ключ валиден, но у него нет права на эту операцию. */
+declare class NaparnikScopeError extends NaparnikError {
+    readonly requiredScope?: string | undefined;
+    constructor(message: string, requiredScope?: string | undefined);
+}
+/**
+ * 402 — не хватает денег. Отдельный класс, потому что это единственная ошибка,
+ * которую пользователь может исправить сам и прямо сейчас: у неё есть сумма и
+ * ссылка, и MCP-тул обязан показать их человеку, а не прятать в стек.
+ */
+declare class NaparnikInsufficientBalanceError extends NaparnikError {
+    readonly details: {
+        /** Что упёрлось: баланс компании или дневной потолок ключа. */
+        limit: 'company_balance' | 'token_daily';
+        balanceRub: number;
+        requiredRub: number;
+        /** Куда идти пополнять (или менять лимит ключа). */
+        actionUrl: string;
+    };
+    constructor(message: string, details: {
+        /** Что упёрлось: баланс компании или дневной потолок ключа. */
+        limit: 'company_balance' | 'token_daily';
+        balanceRub: number;
+        requiredRub: number;
+        /** Куда идти пополнять (или менять лимит ключа). */
+        actionUrl: string;
+    });
+}
+/**
+ * Прочие 4xx — запрос сформирован неверно. Повтор с тем же телом даст тот же
+ * результат, поэтому не ретраим: пусть LLM увидит ошибку и исправит аргументы.
+ */
+declare class NaparnikClientError extends NaparnikError {
+    readonly status: number;
+    readonly body?: string | undefined;
+    constructor(message: string, status: number, body?: string | undefined);
+}
+/** 5xx, сетевой сбой, недоступность — здесь повтор осмыслен. */
+declare class NaparnikServerError extends NaparnikError {
+    readonly status?: number | undefined;
+    readonly body?: string | undefined;
+    constructor(message: string, status?: number | undefined, body?: string | undefined);
+    get retryable(): boolean;
+}
+/**
+ * Таймаут запроса. Ретраить НЕ ретраим осознанно: сервер, вероятно, всё ещё
+ * выполняет операцию, и повтор либо удвоит нагрузку, либо приведёт к двойному
+ * списанию на платных вызовах. Тот же вывод зафиксирован в phpApiCall.
+ */
+declare class NaparnikTimeoutError extends NaparnikError {
+}
+/** Ключ не задан или задан в неверном формате — ошибка конфигурации клиента. */
+declare class NaparnikConfigError extends NaparnikError {
+}
+
+export { NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, type NaparnikMcpConfig, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, createNaparnikTools, loadConfig };

package/dist/index.js

@@ -0,0 +1 @@
+export { NaparnikApiClient, NaparnikAuthError, NaparnikClientError, NaparnikConfigError, NaparnikError, NaparnikInsufficientBalanceError, NaparnikScopeError, NaparnikServerError, NaparnikTimeoutError, createNaparnikTools, loadConfig } from './chunk-T6UWKM37.js';

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@naparnik/mcp",
+  "version": "0.1.0",
+  "description": "MCP-сервер Напарника: подключает рилсы, распаковку бренда, генерацию изображений и баланс к вашему Claude.",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "naparnik-mcp": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/shamysev/ai-naparnik.git",
+    "directory": "new-version/shared/mcp"
+  },
+  "homepage": "https://naparnik.ai",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "naparnik",
+    "reels"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "@naparnik/api-contracts": "file:../api-contracts",
+    "@naparnik/super-agent-core": "file:../../super-agent-core",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.4.0",
+    "vitest": "^3.2.4"
+  }
+}