@tuannvm/telegram-mcp-server 0.0.2

package/README.md

@@ -0,0 +1,141 @@
+# Telegram MCP Server
+
+[![npm version](https://img.shields.io/npm/v/@tuannvm/telegram-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/telegram-mcp-server)
+[![npm downloads](https://img.shields.io/npm/dm/@tuannvm/telegram-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/telegram-mcp-server)
+[![license](https://img.shields.io/npm/l/@tuannvm/telegram-mcp-server.svg)](https://www.npmjs.com/package/@tuannvm/telegram-mcp-server)
+
+Send Telegram notifications from anywhere — works seamlessly across local machines, remote SSH sessions, and containerized environments.
+
+```mermaid
+graph LR
+    A[Claude Code] --> B[Telegram MCP Server]
+    B --> C[Telegram Bot API]
+    C --> D[Your Telegram Chat]
+
+    style A fill:#FF6B35
+    style B fill:#4A90E2
+    style C fill:#0088cc
+    style D fill:#00D4AA
+```
+
+## Quick Start
+
+### 1. Create Telegram Bot
+
+```bash
+# Message @BotFather on Telegram
+/newbot
+# Follow prompts to get your bot token
+```
+
+### 2. Add to Claude Code
+
+```bash
+export TELEGRAM_BOT_TOKEN="your-bot-token"
+export TELEGRAM_CHAT_ID="your-chat-id"
+claude mcp add telegram -- npx -y @tuannvm/telegram-mcp-server
+```
+
+### 3. Start Using
+
+```
+Send notification "✅ DONE" to "Deployment complete"
+Send telegram status to check configuration
+```
+
+## One-Click Install
+
+[![VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=telegram&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@tuannvm/telegram-mcp-server%22%5D%2C%22env%22%3A%7B%22TELEGRAM_BOT_TOKEN%22%3A%22YOUR_BOT_TOKEN%22%2C%22TELEGRAM_CHAT_ID%22%3A%22YOUR_CHAT_ID%22%7D%7D)
+[![VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=telegram&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22@tuannvm/telegram-mcp-server%22%5D%2C%22env%22%3A%7B%22TELEGRAM_BOT_TOKEN%22%3A%22YOUR_BOT_TOKEN%22%2C%22TELEGRAM_CHAT_ID%22%3A%22YOUR_CHAT_ID%22%7D%7D)
+[![Cursor](https://img.shields.io/badge/Cursor-Install-00D8FF?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=telegram&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoibnB4IC15IEB0dWFubnZtL3RlbGVncmFtLW1jcC1zZXJ2ZXIiLCJlbnYiOnsiVEVMRUdSQU1fQk9UX1RPS0VOIjoiWU9VUl9CT1RfVE9LRU4iLCJURUxFR1JBTV9DSEFUX0lEIjoiWU9VUl9DSEFUX0lEIn19)
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `send_telegram` | Send Telegram notifications with HTML formatting |
+| `telegram_status` | Check if Telegram credentials are configured |
+
+## Examples
+
+**Simple notification:**
+```
+Send notification "✅ DONE" to "Build completed successfully"
+```
+
+**With context:**
+```
+Send notification "🚫 BLOCKED" to "Need approval to continue
+
+📁 /path/to/project
+🌿 Branch: feature/new-auth
+💻 Host: production-server
+
+Task: Deploying to production
+Issue: Requires manual approval"
+```
+
+**Error reporting:**
+```
+Send notification "❌ ERROR" to "Deployment failed
+
+Error: Database connection timeout
+Exit code: 1
+Duration: 45s"
+```
+
+**Status check:**
+```
+Send telegram status to verify configuration
+```
+
+## Getting Your Chat ID
+
+```bash
+# After creating your bot, send a message to it
+# Then visit this URL in your browser:
+https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates
+
+# Look for "chat":{"id":123456789} in the response
+```
+
+## Requirements
+
+- **Telegram Bot Token** — Create a bot via @BotFather on Telegram
+- **Telegram Chat ID** — Your personal Telegram chat ID or group ID
+- **Node.js 18+** — For local development
+
+## Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `TELEGRAM_BOT_TOKEN` | Your Telegram bot token from @BotFather | Yes |
+| `TELEGRAM_CHAT_ID` | Target chat ID for notifications | Yes |
+
+## Development
+
+```bash
+npm install    # Install dependencies
+npm run dev    # Development mode
+npm run build  # Build for production
+npm test       # Run tests
+npm run lint   # Run ESLint
+```
+
+## How It Works
+
+This MCP server runs as a separate process communicating via stdio. When you call `send_telegram`:
+
+1. The MCP server receives the request via stdio
+2. It makes an HTTP request to Telegram's Bot API
+3. Your notification appears instantly on Telegram
+
+This works reliably across:
+- Local development machines
+- Remote SSH sessions
+- Containerized environments
+- CI/CD pipelines
+
+## License
+
+ISC

package/dist/__tests__/server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.test.d.ts.map

package/dist/__tests__/server.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/server.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/server.test.js

@@ -0,0 +1,12 @@
+import { TelegramMcpServer } from '../server.js';
+describe('TelegramMcpServer', () => {
+    it('should instantiate with correct config', () => {
+        const config = {
+            name: 'test-server',
+            version: '1.0.0',
+        };
+        const server = new TelegramMcpServer(config);
+        expect(server).toBeInstanceOf(TelegramMcpServer);
+    });
+});
+//# sourceMappingURL=server.test.js.map

package/dist/__tests__/server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.test.js","sourceRoot":"","sources":["../../src/__tests__/server.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,OAAO;SACjB,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+export declare class ToolExecutionError extends Error {
+    readonly toolName: string;
+    readonly cause?: unknown | undefined;
+    constructor(toolName: string, message: string, cause?: unknown | undefined);
+}
+export declare class ValidationError extends Error {
+    readonly toolName: string;
+    constructor(toolName: string, message: string);
+}
+export declare function handleError(error: unknown, context: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;aAEzB,QAAQ,EAAE,MAAM;aAEhB,KAAK,CAAC,EAAE,OAAO;gBAFf,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC;AAED,qBAAa,eAAgB,SAAQ,KAAK;aAEtB,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM,EAChC,OAAO,EAAE,MAAM;CAKlB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKnE"}

package/dist/errors.js

@@ -0,0 +1,25 @@
+export class ToolExecutionError extends Error {
+    toolName;
+    cause;
+    constructor(toolName, message, cause) {
+        super(`Failed to execute tool "${toolName}": ${message}`);
+        this.toolName = toolName;
+        this.cause = cause;
+        this.name = 'ToolExecutionError';
+    }
+}
+export class ValidationError extends Error {
+    toolName;
+    constructor(toolName, message) {
+        super(`Validation failed for tool "${toolName}": ${message}`);
+        this.toolName = toolName;
+        this.name = 'ValidationError';
+    }
+}
+export function handleError(error, context) {
+    if (error instanceof Error) {
+        return `Error in ${context}: ${error.message}`;
+    }
+    return `Error in ${context}: ${String(error)}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAEzB;IAEA;IAHlB,YACkB,QAAgB,EAChC,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,2BAA2B,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAJ1C,aAAQ,GAAR,QAAQ,CAAQ;QAEhB,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAEtB;IADlB,YACkB,QAAgB,EAChC,OAAe;QAEf,KAAK,CAAC,+BAA+B,QAAQ,MAAM,OAAO,EAAE,CAAC,CAAC;QAH9C,aAAQ,GAAR,QAAQ,CAAQ;QAIhC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,OAAe;IACzD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,YAAY,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * Telegram MCP Server
+ *
+ * Environment variables:
+ *   TELEGRAM_BOT_TOKEN - Your Telegram bot token
+ *   TELEGRAM_CHAT_ID   - Target chat ID for notifications
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Telegram MCP Server
+ *
+ * Environment variables:
+ *   TELEGRAM_BOT_TOKEN - Your Telegram bot token
+ *   TELEGRAM_CHAT_ID   - Target chat ID for notifications
+ */
+import chalk from 'chalk';
+import { TelegramMcpServer } from './server.js';
+const SERVER_CONFIG = {
+    name: 'telegram-mcp-server',
+    version: '1.0.0',
+};
+async function main() {
+    try {
+        const server = new TelegramMcpServer(SERVER_CONFIG);
+        await server.start();
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to start server:'), error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;CACR,CAAC;AAEX,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { type ServerConfig } from './types.js';
+export declare class TelegramMcpServer {
+    private readonly server;
+    private readonly config;
+    constructor(config: ServerConfig);
+    private setupHandlers;
+    private isValidToolName;
+    start(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAC;AAKpB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAiBhC,OAAO,CAAC,aAAa;IA4DrB,OAAO,CAAC,eAAe;IAIjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/server.js

@@ -0,0 +1,90 @@
+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 chalk from 'chalk';
+import { TOOLS, } from './types.js';
+import { handleError } from './errors.js';
+import { toolDefinitions } from './tools/definitions.js';
+import { toolHandlers } from './tools/handlers.js';
+export class TelegramMcpServer {
+    server;
+    config;
+    constructor(config) {
+        this.config = config;
+        this.server = new Server({
+            name: config.name,
+            version: config.version,
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        // List tools handler
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            return { tools: toolDefinitions };
+        });
+        // Call tool handler
+        this.server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+            const { name, arguments: args } = request.params;
+            const progressToken = request.params._meta?.progressToken;
+            // Create progress sender that uses MCP notifications
+            const createProgressContext = () => {
+                let progressCount = 0;
+                return {
+                    progressToken,
+                    sendProgress: async (message, progress, total) => {
+                        if (!progressToken)
+                            return;
+                        progressCount++;
+                        try {
+                            await extra.sendNotification({
+                                method: 'notifications/progress',
+                                params: {
+                                    progressToken,
+                                    progress: progress ?? progressCount,
+                                    total,
+                                    message,
+                                },
+                            });
+                        }
+                        catch (err) {
+                            // Log but don't fail the operation if progress notification fails
+                            console.error(chalk.yellow('Failed to send progress notification:'), err);
+                        }
+                    },
+                };
+            };
+            try {
+                if (!this.isValidToolName(name)) {
+                    throw new Error(`Unknown tool: ${name}`);
+                }
+                const handler = toolHandlers[name];
+                const context = createProgressContext();
+                return await handler.execute(args, context);
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: handleError(error, `tool "${name}"`),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        });
+    }
+    isValidToolName(name) {
+        return Object.values(TOOLS).includes(name);
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        console.error(chalk.green(`${this.config.name} started successfully`));
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/definitions.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '../types.js';
+export declare const toolDefinitions: ToolDefinition[];
+//# sourceMappingURL=definitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,eAAe,EAAE,cAAc,EA6C3C,CAAC"}

package/dist/tools/definitions.js

@@ -0,0 +1,45 @@
+import { TOOLS } from '../types.js';
+export const toolDefinitions = [
+    {
+        name: TOOLS.SEND_TELEGRAM,
+        description: 'Send a Telegram notification. Use for alerts, completion notices, or when blocked awaiting input.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                header: {
+                    type: 'string',
+                    description: 'Message header/title. Use emoji + status like: ✅ DONE, 🚫 BLOCKED, ❌ ERROR',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Optional message body with details. Can be multiline. Supports basic context like PWD, branch, host.',
+                },
+            },
+            required: ['header'],
+        },
+        annotations: {
+            title: 'Send Telegram',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    },
+    {
+        name: TOOLS.TELEGRAM_STATUS,
+        description: 'Check if Telegram credentials are configured',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        annotations: {
+            title: 'Telegram Status',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/tools/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAuB,MAAM,aAAa,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C;QACE,IAAI,EAAE,KAAK,CAAC,aAAa;QACzB,WAAW,EACT,mGAAmG;QACrG,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,4EAA4E;iBAC/E;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,sGAAsG;iBACzG;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;QACD,WAAW,EAAE;YACX,KAAK,EAAE,eAAe;YACtB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,IAAI;SACpB;KACF;IACD;QACE,IAAI,EAAE,KAAK,CAAC,eAAe;QAC3B,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;QACD,WAAW,EAAE;YACX,KAAK,EAAE,iBAAiB;YACxB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF;CACF,CAAC"}

package/dist/tools/handlers.d.ts

@@ -0,0 +1,12 @@
+import { type ToolResult, type ToolHandlerContext } from '../types.js';
+export declare class SendTelegramToolHandler {
+    execute(args: unknown, _context?: ToolHandlerContext): Promise<ToolResult>;
+}
+export declare class TelegramStatusToolHandler {
+    execute(args: unknown, _context?: ToolHandlerContext): Promise<ToolResult>;
+}
+export declare const toolHandlers: {
+    readonly send_telegram: SendTelegramToolHandler;
+    readonly telegram_status: TelegramStatusToolHandler;
+};
+//# sourceMappingURL=handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAKxB,MAAM,aAAa,CAAC;AA0HrB,qBAAa,uBAAuB;IAC5B,OAAO,CACX,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,kBAAmC,GAC5C,OAAO,CAAC,UAAU,CAAC;CA6BvB;AAED,qBAAa,yBAAyB;IAC9B,OAAO,CACX,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,kBAAmC,GAC5C,OAAO,CAAC,UAAU,CAAC;CA4BvB;AAGD,eAAO,MAAM,YAAY;;;CAGf,CAAC"}

package/dist/tools/handlers.js

@@ -0,0 +1,154 @@
+import { TOOLS, SendTelegramToolSchema, TelegramStatusToolSchema, } from '../types.js';
+import { ToolExecutionError, ValidationError } from '../errors.js';
+import { ZodError } from 'zod';
+// Default no-op context for handlers that don't need progress
+const defaultContext = {
+    sendProgress: async () => { },
+};
+/**
+ * Escape HTML special characters to prevent injection
+ */
+function escapeHtml(text) {
+    const htmlEscapeMap = {
+        '&': '&',
+        '<': '&lt;',
+        '>': '&gt;',
+    };
+    return text.replace(/[&<>]/g, (char) => htmlEscapeMap[char]);
+}
+/**
+ * Get Telegram configuration at runtime
+ */
+function getTelegramConfig() {
+    return {
+        botToken: process.env.TELEGRAM_BOT_TOKEN,
+        chatId: process.env.TELEGRAM_CHAT_ID,
+    };
+}
+async function sendTelegramMessage(header, body) {
+    const { botToken, chatId } = getTelegramConfig();
+    if (!botToken || !chatId) {
+        return {
+            success: false,
+            error: 'Missing TELEGRAM_BOT_TOKEN or TELEGRAM_CHAT_ID environment variables',
+        };
+    }
+    // Escape HTML special characters to prevent injection
+    const escapedHeader = escapeHtml(header);
+    const escapedBody = body ? escapeHtml(body) : undefined;
+    const message = escapedBody
+        ? `<b>${escapedHeader}</b>\n\n${escapedBody}`
+        : escapedHeader;
+    // Setup timeout for fetch request
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 10000); // 10s timeout
+    try {
+        const response = await fetch(`https://api.telegram.org/bot${botToken}/sendMessage`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                chat_id: chatId,
+                text: message,
+                parse_mode: 'HTML',
+                disable_web_page_preview: true,
+            }),
+            signal: controller.signal,
+        });
+        // Clear timeout as request completed
+        clearTimeout(timeoutId);
+        // Check HTTP status code
+        if (!response.ok) {
+            return {
+                success: false,
+                error: `HTTP ${response.status}: ${response.statusText}`,
+            };
+        }
+        // Handle non-JSON responses
+        const contentType = response.headers.get('content-type');
+        if (!contentType?.includes('application/json')) {
+            const text = await response.text();
+            return {
+                success: false,
+                error: `Unexpected response type: ${contentType || 'unknown'}. Response: ${text.slice(0, 200)}`,
+            };
+        }
+        const data = (await response.json());
+        if (data.ok) {
+            return { success: true, messageId: data.result?.message_id };
+        }
+        else {
+            return { success: false, error: data.description || 'Unknown error' };
+        }
+    }
+    catch (error) {
+        // Clear timeout if still active
+        clearTimeout(timeoutId);
+        // Handle timeout specifically
+        if (error instanceof Error && error.name === 'AbortError') {
+            return {
+                success: false,
+                error: 'Request timeout (10s)',
+            };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+export class SendTelegramToolHandler {
+    async execute(args, _context = defaultContext) {
+        try {
+            const { header, body } = SendTelegramToolSchema.parse(args);
+            const result = await sendTelegramMessage(header, body);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result.success
+                            ? `✓ Telegram sent (ID: ${result.messageId})`
+                            : `✗ Failed: ${result.error}`,
+                    },
+                ],
+                isError: !result.success,
+            };
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                throw new ValidationError(TOOLS.SEND_TELEGRAM, error.message);
+            }
+            throw new ToolExecutionError(TOOLS.SEND_TELEGRAM, 'Failed to send Telegram message', error);
+        }
+    }
+}
+export class TelegramStatusToolHandler {
+    async execute(args, _context = defaultContext) {
+        try {
+            // Handle undefined args for no-argument tools
+            TelegramStatusToolSchema.parse(args ?? {});
+            const { botToken, chatId } = getTelegramConfig();
+            const hasToken = !!botToken;
+            const hasChatId = !!chatId;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Telegram Config:\n  BOT_TOKEN: ${hasToken ? '✓ Set' : '✗ Missing'}\n  CHAT_ID: ${hasChatId ? '✓ Set' : '✗ Missing'}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof ZodError) {
+                throw new ValidationError(TOOLS.TELEGRAM_STATUS, error.message);
+            }
+            throw new ToolExecutionError(TOOLS.TELEGRAM_STATUS, 'Failed to check Telegram status', error);
+        }
+    }
+}
+// Tool handler registry
+export const toolHandlers = {
+    [TOOLS.SEND_TELEGRAM]: new SendTelegramToolHandler(),
+    [TOOLS.TELEGRAM_STATUS]: new TelegramStatusToolHandler(),
+};
+//# sourceMappingURL=handlers.js.map

package/dist/tools/handlers.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const TOOLS: {
+    readonly SEND_TELEGRAM: "send_telegram";
+    readonly TELEGRAM_STATUS: "telegram_status";
+};
+export type ToolName = typeof TOOLS[keyof typeof TOOLS];
+export interface ToolAnnotations {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+export interface ToolDefinition {
+    name: ToolName;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+    annotations?: ToolAnnotations;
+}
+export interface ToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+}
+export interface ServerConfig {
+    name: string;
+    version: string;
+}
+export interface TelegramResponse {
+    ok: boolean;
+    description?: string;
+    result?: {
+        message_id: number;
+    };
+}
+export interface SendTelegramResult {
+    success: boolean;
+    messageId?: number;
+    error?: string;
+}
+export type ProgressToken = string | number;
+export interface ToolHandlerContext {
+    progressToken?: ProgressToken;
+    sendProgress: (message: string, progress?: number, total?: number) => Promise<void>;
+}
+export declare const SendTelegramToolSchema: z.ZodObject<{
+    header: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const TelegramStatusToolSchema: z.ZodObject<{}, z.core.$strip>;
+export type SendTelegramToolArgs = z.infer<typeof SendTelegramToolSchema>;
+export type TelegramStatusToolArgs = z.infer<typeof TelegramStatusToolSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,KAAK;;;CAGR,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAGxD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAGD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAGD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAGD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAGD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAG5C,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAGD,eAAO,MAAM,sBAAsB;;;iBAGjC,CAAC;AAEH,eAAO,MAAM,wBAAwB,gCAAe,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+// Tool constants
+export const TOOLS = {
+    SEND_TELEGRAM: 'send_telegram',
+    TELEGRAM_STATUS: 'telegram_status',
+};
+// Zod schemas for tool arguments
+export const SendTelegramToolSchema = z.object({
+    header: z.string().describe('Message header/title. Use emoji + status like: ✅ DONE, 🚫 BLOCKED, ❌ ERROR'),
+    body: z.string().optional().describe('Optional message body with details. Can be multiline. Supports basic context like PWD, branch, host.'),
+});
+export const TelegramStatusToolSchema = z.object({});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iBAAiB;AACjB,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAkEX,iCAAiC;AACjC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4EAA4E,CAAC;IACzG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sGAAsG,CAAC;CAC7I,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@tuannvm/telegram-mcp-server",
+  "version": "0.0.2",
+  "description": "MCP server for Telegram notifications - send notifications from Claude Code to Telegram",
+  "main": "dist/index.js",
+  "bin": {
+    "telegram-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "directories": {
+    "doc": "docs"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write src/**/*.ts",
+    "format:check": "prettier --check src/**/*.ts",
+    "clean": "rm -rf dist"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tuannvm/telegram-mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "telegram",
+    "notifications",
+    "claude",
+    "ai",
+    "cli"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/tuannvm/telegram-mcp-server/issues"
+  },
+  "homepage": "https://github.com/tuannvm/telegram-mcp-server#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chalk": "^5.6.0",
+    "zod": "^4.0.17"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.39.1",
+    "@typescript-eslint/parser": "^8.39.1",
+    "eslint": "^9.33.0",
+    "jest": "^30.0.5",
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.1",
+    "tsx": "^4.20.4",
+    "typescript": "^5.0.0"
+  }
+}