@zeph-to/mcp-server 0.2.0 → 0.3.0

package/dist/api-client.js

@@ -43,7 +43,7 @@ class ZephApiClient {
         return this.request('GET', `/pushes${qs ? `?${qs}` : ''}`);
     }
     async dismissPush(pushId) {
-        return this.request('POST', `/pushes/${pushId}/dismiss`);
+        return this.request('POST', `/pushes/${encodeURIComponent(pushId)}/dismiss`);
     }
     async dismissAllPushes() {
         return this.request('POST', '/pushes/dismiss-all');

package/dist/index.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const path_1 = require("path");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const config_js_1 = require("./config.js");
@@ -15,12 +17,21 @@ const broadcast_js_1 = require("./tools/broadcast.js");
 const file_js_1 = require("./tools/file.js");
 const devices_js_1 = require("./resources/devices.js");
 const channels_js_1 = require("./resources/channels.js");
+const getVersion = () => {
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '0.0.0';
+    }
+};
 const createServer = () => {
     const config = (0, config_js_1.loadConfig)();
     const client = new api_client_js_1.ZephApiClient(config);
     const server = new mcp_js_1.McpServer({
         name: 'zeph',
-        version: '0.2.0',
+        version: getVersion(),
     }, {
         instructions: [
             'Zeph MCP Server — Send notifications, files, clipboard text, broadcast to channels, manage push history, and interact with users across their devices.',

package/dist/tools/broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/tools/broadcast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAiC7E,CAAC"}
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../src/tools/broadcast.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAsC7E,CAAC"}

package/dist/tools/broadcast.js

@@ -6,6 +6,11 @@ const error_format_js_1 = require("../error-format.js");
 const registerBroadcastTool = (server, client) => {
     server.registerTool('zeph_broadcast', {
         description: 'Send a push notification to all subscribers of a channel. Use zeph://channels resource to find available channels.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             channelId: zod_1.z.string().describe('Channel ID to broadcast to (e.g., "ch_...")'),
             title: zod_1.z.string().describe('Notification title'),

package/dist/tools/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/tools/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAyBtG,CAAC"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/tools/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SA8BtG,CAAC"}

package/dist/tools/clipboard.js

@@ -6,6 +6,11 @@ const error_format_js_1 = require("../error-format.js");
 const registerClipboardTool = (server, client, config) => {
     server.registerTool('zeph_clipboard', {
         description: 'Copy text to the user\'s device clipboard. The text will appear in their clipboard history and can be pasted immediately.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             text: zod_1.z.string().describe('Text to copy to clipboard'),
             targetDeviceId: zod_1.z.string().optional().describe('Target device ID. Omit to use configured default or send to all devices.'),

package/dist/tools/dismiss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dismiss.d.ts","sourceRoot":"","sources":["../../src/tools/dismiss.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAmB3E,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAiB9E,CAAC"}
+{"version":3,"file":"dismiss.d.ts","sourceRoot":"","sources":["../../src/tools/dismiss.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAyB3E,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAuB9E,CAAC"}

package/dist/tools/dismiss.js

@@ -6,6 +6,12 @@ const error_format_js_1 = require("../error-format.js");
 const registerDismissTool = (server, client) => {
     server.registerTool('zeph_dismiss', {
         description: 'Dismiss (mark as read) a specific push notification by ID. Use after processing a notification to clear it from the user\'s feed.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {
             pushId: zod_1.z.string().describe('Push ID to dismiss (e.g., "push_01HX...")'),
         },
@@ -23,6 +29,12 @@ exports.registerDismissTool = registerDismissTool;
 const registerDismissAllTool = (server, client) => {
     server.registerTool('zeph_dismiss_all', {
         description: 'Dismiss all push notifications at once. Clears the entire notification feed.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
         inputSchema: {},
     }, async () => {
         try {

package/dist/tools/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/tools/file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAyCjG,CAAC"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/tools/file.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SA8CjG,CAAC"}

package/dist/tools/file.js

@@ -6,6 +6,11 @@ const error_format_js_1 = require("../error-format.js");
 const registerFileTool = (server, client, config) => {
     server.registerTool('zeph_file', {
         description: 'Send a text file to the user\'s device. The content is uploaded and delivered as a file push. Use for logs, reports, code snippets, or any text content.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             fileName: zod_1.z.string().describe('File name with extension (e.g., "report.txt", "output.json")'),
             content: zod_1.z.string().describe('Text content of the file'),

package/dist/tools/input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/tools/input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAkDlG,CAAC"}
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/tools/input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,iBAAiB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAuDlG,CAAC"}

package/dist/tools/input.js

@@ -7,6 +7,11 @@ const poll_js_1 = require("../poll.js");
 const registerInputTool = (server, client, config) => {
     server.registerTool('zeph_input', {
         description: 'Request text input from the user via push notification. The tool blocks until the user responds or the timeout is reached. Requires ZEPH_HOOK_ID environment variable.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             title: zod_1.z.string().describe('Input request title'),
             body: zod_1.z.string().optional().describe('Instructions or context'),

package/dist/tools/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAmCxE,CAAC"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/tools/list.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,gBAAgB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,SAwCxE,CAAC"}

package/dist/tools/list.js

@@ -6,6 +6,11 @@ const error_format_js_1 = require("../error-format.js");
 const registerListTool = (server, client) => {
     server.registerTool('zeph_list', {
         description: 'List recent push notifications. Use this to check notification history, avoid duplicates, or reference previous messages.',
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             limit: zod_1.z
                 .number()

package/dist/tools/notify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/tools/notify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAiCnG,CAAC"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/tools/notify.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAsCnG,CAAC"}

package/dist/tools/notify.js

@@ -6,6 +6,11 @@ const error_format_js_1 = require("../error-format.js");
 const registerNotifyTool = (server, client, config) => {
     server.registerTool('zeph_notify', {
         description: 'Send a one-way push notification to the user\'s devices. Use this to inform the user about task completion, errors, or status updates.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             title: zod_1.z.string().describe('Notification title'),
             body: zod_1.z.string().optional().describe('Notification body text'),

package/dist/tools/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/tools/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAiEnG,CAAC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/tools/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAAI,QAAQ,SAAS,EAAE,QAAQ,aAAa,EAAE,QAAQ,eAAe,SAsEnG,CAAC"}

package/dist/tools/prompt.js

@@ -7,6 +7,11 @@ const poll_js_1 = require("../poll.js");
 const registerPromptTool = (server, client, config) => {
     server.registerTool('zeph_prompt', {
         description: 'Ask the user to choose from predefined options via push notification. The tool blocks until the user responds or the timeout is reached. Requires ZEPH_HOOK_ID environment variable.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
         inputSchema: {
             title: zod_1.z.string().describe('Question or request title'),
             body: zod_1.z.string().optional().describe('Detailed description'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Zeph MCP server — AI agent notifications, prompts, and input via MCP protocol",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -28,6 +28,6 @@
     "directory": "libs/mcp-server"
   },
   "homepage": "https://github.com/tak-bro/encl/tree/main/libs/mcp-server",
-  "keywords": ["zeph", "mcp", "ai", "notification", "prompt", "model-context-protocol"],
+  "keywords": ["zeph", "mcp", "ai", "notification", "prompt", "model-context-protocol", "claude", "ai-agent", "devtools", "cursor", "gemini"],
   "license": "MIT"
 }