@happ-ai/platform-mcp 0.3.0

package/dist/tools/phones.tools.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import { happRequest } from "../http.js";
+import { jsonResult } from "./result.js";
+export function registerPhonesTools(server) {
+    server.registerTool("happ_phones_list", {
+        title: "Телефоны",
+        description: "Список SIP-телефонов компании (GET /assistant-phones-new). Телефон в Happ — это SIP-учётка: номер + sipLogin + хост телефонии.",
+        inputSchema: {
+            companyId: z.string().uuid().optional().describe("ID компании"),
+            assistantId: z.string().uuid().optional().describe("Фильтр по ассистенту")
+        }
+    }, async ({ companyId, assistantId }) => {
+        const phones = await happRequest("GET", "/assistant-phones-new", { params: { companyId, assistantId } });
+        return jsonResult(phones);
+    });
+    server.registerTool("happ_phone_create", {
+        title: "Добавить телефон",
+        description: "Регистрирует SIP-телефон (POST /assistant-phones-new). Нужны данные SIP-транка от провайдера телефонии. К ассистенту привязывается отдельно через happ_phone_attach.",
+        inputSchema: {
+            companyId: z.string().uuid().describe("ID компании"),
+            phoneNumber: z.string().optional().describe("Номер телефона"),
+            sipLogin: z.string().optional().describe("SIP-логин"),
+            password: z.string().optional().describe("SIP-пароль"),
+            telephonyUrl: z.string().optional().describe("SIP-хост без протокола, например sip.provider.com:5060"),
+            comment: z.string().optional().describe("Комментарий"),
+            codec: z.string().optional().describe("Аудиокодек, если требует транк")
+        }
+    }, async (input) => {
+        const body = Object.fromEntries(Object.entries(input).filter(([, v]) => v !== undefined));
+        const phone = await happRequest("POST", "/assistant-phones-new", { body });
+        return jsonResult(phone);
+    });
+    server.registerTool("happ_phone_get", {
+        title: "Телефон",
+        description: "Детали телефона по id (GET /assistant-phones-new/:id).",
+        inputSchema: {
+            phoneId: z.string().uuid().describe("ID телефона")
+        }
+    }, async ({ phoneId }) => {
+        const phone = await happRequest("GET", `/assistant-phones-new/${phoneId}`);
+        return jsonResult(phone);
+    });
+    server.registerTool("happ_phone_update", {
+        title: "Обновить телефон",
+        description: "Обновляет SIP-настройки телефона (PATCH /assistant-phones-new/:id). Передавай только изменяемые поля. Если телефон привязан к ассистенту — VA-регистрация пере-синкнется.",
+        inputSchema: {
+            phoneId: z.string().uuid().describe("ID телефона"),
+            phoneNumber: z.string().optional().describe("Номер телефона"),
+            sipLogin: z.string().optional().describe("SIP-логин"),
+            password: z.string().optional().describe("SIP-пароль"),
+            telephonyUrl: z.string().optional().describe("SIP-хост"),
+            comment: z.string().optional().describe("Комментарий"),
+            codec: z.string().optional().describe("Аудиокодек")
+        }
+    }, async ({ phoneId, ...rest }) => {
+        const body = Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== undefined));
+        const phone = await happRequest("PATCH", `/assistant-phones-new/${phoneId}`, { body });
+        return jsonResult(phone);
+    });
+    server.registerTool("happ_phone_delete", {
+        title: "Удалить телефон",
+        description: "Удаляет телефон из платформы (DELETE /assistant-phones-new/:id).",
+        inputSchema: {
+            phoneId: z.string().uuid().describe("ID телефона")
+        }
+    }, async ({ phoneId }) => {
+        const result = await happRequest("DELETE", `/assistant-phones-new/${phoneId}`);
+        return jsonResult(result);
+    });
+    server.registerTool("happ_phone_attach", {
+        title: "Привязать телефон к ассистенту",
+        description: "Привязывает существующий телефон к ассистенту (POST /assistant-phones-new/attach).",
+        inputSchema: {
+            phoneId: z.string().uuid().describe("ID телефона"),
+            assistantId: z.string().uuid().describe("ID ассистента")
+        }
+    }, async ({ phoneId, assistantId }) => {
+        const result = await happRequest("POST", "/assistant-phones-new/attach", { body: { phoneId, assistantId } });
+        return jsonResult(result);
+    });
+    server.registerTool("happ_phone_detach", {
+        title: "Отвязать телефон",
+        description: "Отвязывает телефон от ассистента (POST /assistant-phones-new/detach).",
+        inputSchema: {
+            phoneId: z.string().uuid().describe("ID телефона")
+        }
+    }, async ({ phoneId }) => {
+        const result = await happRequest("POST", "/assistant-phones-new/detach", { body: { phoneId } });
+        return jsonResult(result);
+    });
+}
+//# sourceMappingURL=phones.tools.js.map

package/dist/tools/phones.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phones.tools.js","sourceRoot":"","sources":["../../src/tools/phones.tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/result.js

@@ -0,0 +1,7 @@
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function jsonResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU,CAAC,IAAY;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa;IACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@happ-ai/platform-mcp",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "MCP server exposing the Happ platform API as tools (login, companies, assistants, channels, phones)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Happ-AI/platform-mcp.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "happ": "dist/index.js",
+    "happ-dev": "dist/index.js",
+    "happ-mcp": "dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  }
+}