@node2flow/telegram-bot-mcp 1.0.0

package/dist/server.js

@@ -0,0 +1,146 @@
+/**
+ * Shared MCP Server — used by both Node.js (index.ts) and CF Worker (worker.ts)
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { TelegramClient } from './client.js';
+import { TOOLS } from './tools.js';
+export function handleToolCall(toolName, args, client) {
+    switch (toolName) {
+        // ========== Bot Info ==========
+        case 'tg_get_me':
+            return client.getMe();
+        case 'tg_set_my_commands':
+            return client.setMyCommands(args.commands, args.scope, args.language_code);
+        // ========== Send Messages ==========
+        case 'tg_send_message': {
+            const { chat_id, text, ...opts } = args;
+            return client.sendMessage(chat_id, text, opts);
+        }
+        case 'tg_send_photo': {
+            const { chat_id, photo, ...opts } = args;
+            return client.sendPhoto(chat_id, photo, opts);
+        }
+        case 'tg_send_document': {
+            const { chat_id, document, ...opts } = args;
+            return client.sendDocument(chat_id, document, opts);
+        }
+        case 'tg_send_video': {
+            const { chat_id, video, ...opts } = args;
+            return client.sendVideo(chat_id, video, opts);
+        }
+        case 'tg_send_audio': {
+            const { chat_id, audio, ...opts } = args;
+            return client.sendAudio(chat_id, audio, opts);
+        }
+        case 'tg_send_location': {
+            const { chat_id, latitude, longitude, ...opts } = args;
+            return client.sendLocation(chat_id, latitude, longitude, opts);
+        }
+        case 'tg_send_poll': {
+            const { chat_id, question, options, ...opts } = args;
+            return client.sendPoll(chat_id, question, options, opts);
+        }
+        case 'tg_send_contact': {
+            const { chat_id, phone_number, first_name, ...opts } = args;
+            return client.sendContact(chat_id, phone_number, first_name, opts);
+        }
+        // ========== Edit/Delete Messages ==========
+        case 'tg_edit_message_text': {
+            const { chat_id, message_id, text, ...opts } = args;
+            return client.editMessageText(chat_id, message_id, text, opts);
+        }
+        case 'tg_edit_message_caption': {
+            const { chat_id, message_id, ...opts } = args;
+            return client.editMessageCaption(chat_id, message_id, opts);
+        }
+        case 'tg_delete_message':
+            return client.deleteMessage(args.chat_id, args.message_id);
+        // ========== Chat Management ==========
+        case 'tg_get_chat':
+            return client.getChat(args.chat_id);
+        case 'tg_get_chat_member_count':
+            return client.getChatMemberCount(args.chat_id);
+        case 'tg_get_chat_member':
+            return client.getChatMember(args.chat_id, args.user_id);
+        case 'tg_ban_chat_member': {
+            const { chat_id, user_id, ...opts } = args;
+            return client.banChatMember(chat_id, user_id, opts);
+        }
+        case 'tg_unban_chat_member': {
+            const { chat_id, user_id, ...opts } = args;
+            return client.unbanChatMember(chat_id, user_id, opts);
+        }
+        // ========== Webhooks ==========
+        case 'tg_set_webhook': {
+            const { url, ...opts } = args;
+            return client.setWebhook(url, opts);
+        }
+        case 'tg_delete_webhook':
+            return client.deleteWebhook(args.drop_pending_updates !== undefined
+                ? { drop_pending_updates: args.drop_pending_updates }
+                : undefined);
+        case 'tg_get_webhook_info':
+            return client.getWebhookInfo();
+        // ========== Callbacks & Files ==========
+        case 'tg_answer_callback_query': {
+            const { callback_query_id, ...opts } = args;
+            return client.answerCallbackQuery(callback_query_id, opts);
+        }
+        case 'tg_get_file':
+            return client.getFile(args.file_id);
+        case 'tg_get_user_profile_photos': {
+            const { user_id, ...opts } = args;
+            return client.getUserProfilePhotos(user_id, opts);
+        }
+        // ========== Pins & Invite Links ==========
+        case 'tg_pin_chat_message': {
+            const { chat_id, message_id, ...opts } = args;
+            return client.pinChatMessage(chat_id, message_id, opts);
+        }
+        case 'tg_unpin_chat_message':
+            return client.unpinChatMessage(args.chat_id, args.message_id);
+        case 'tg_create_chat_invite_link': {
+            const { chat_id, ...opts } = args;
+            return client.createChatInviteLink(chat_id, opts);
+        }
+        default:
+            throw new Error(`Unknown tool: ${toolName}`);
+    }
+}
+export function createServer(config) {
+    const server = new McpServer({
+        name: 'telegram-bot-mcp',
+        version: '1.0.0',
+    });
+    let client = null;
+    for (const tool of TOOLS) {
+        server.tool(tool.name, tool.description, tool.inputSchema, async (args) => {
+            const botToken = config?.botToken ||
+                args.TELEGRAM_BOT_TOKEN;
+            if (!botToken) {
+                return {
+                    content: [{ type: 'text', text: 'Error: TELEGRAM_BOT_TOKEN is required' }],
+                    isError: true,
+                };
+            }
+            if (!client || config?.botToken !== botToken) {
+                client = new TelegramClient({ botToken });
+            }
+            try {
+                const result = await handleToolCall(tool.name, args, client);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    isError: false,
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+    return server;
+}
+//# 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.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Telegram Bot API - MCP Tool Definitions (27 tools)
+ */
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export declare const TOOLS: MCPToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,eAAO,MAAM,KAAK,EAAE,iBAAiB,EA2iBpC,CAAC"}