@ebowwa/mcp-telegram 0.1.4

package/auth-verify.ts

@@ -0,0 +1,180 @@
+#!/usr/bin/env bun
+/**
+ * Telegram Authentication Script (Non-interactive)
+ *
+ * Usage:
+ *   Step 1 - Request code:
+ *     doppler run --project seed --config prd -- bun run auth-verify.ts +1234567890
+ *
+ *   Step 2 - Verify with code:
+ *     doppler run --project seed --config prd -- bun run auth-verify.ts +1234567890 12345
+ *
+ *   Step 3 - With 2FA password:
+ *     doppler run --project seed --config prd -- bun run auth-verify.ts +1234567890 12345 "mypassword"
+ */
+
+import { TelegramClient, Api } from "telegram";
+import { StringSession } from "telegram/sessions";
+import { homedir } from "os";
+import { join } from "path";
+import { mkdirSync, existsSync, writeFileSync, readFileSync } from "fs";
+
+const SESSION_DIR = join(homedir(), ".telegram-mcp");
+const SESSION_FILE = join(SESSION_DIR, "session.txt");
+const PHONE_CODE_HASH_FILE = join(SESSION_DIR, "phone_code_hash.txt");
+
+// Ensure session directory exists
+if (!existsSync(SESSION_DIR)) {
+  mkdirSync(SESSION_DIR, { recursive: true });
+}
+
+async function main() {
+  const apiId = parseInt(process.env.TELEGRAM_API_ID || "0");
+  const apiHash = process.env.TELEGRAM_API_HASH;
+
+  if (!apiId || !apiHash) {
+    console.error("ERROR: TELEGRAM_API_ID and TELEGRAM_API_HASH must be set");
+    console.error("Run with: doppler run --project seed --config prd -- bun run auth-verify.ts ...");
+    process.exit(1);
+  }
+
+  const phoneNumber = process.argv[2];
+  const code = process.argv[3];
+  const password = process.argv[4] || "";
+
+  if (!phoneNumber) {
+    console.error("Usage: bun run auth-verify.ts <phone> [code] [password]");
+    console.error("  phone: Phone number with country code (e.g., +1234567890)");
+    console.error("  code: Verification code (optional, for step 2)");
+    console.error("  password: 2FA password (optional)");
+    process.exit(1);
+  }
+
+  // Check for existing session
+  if (existsSync(SESSION_FILE)) {
+    const existingSession = readFileSync(SESSION_FILE, "utf-8").trim();
+    if (existingSession && !code) {
+      console.log("Found existing session, testing connection...");
+      const session = new StringSession(existingSession);
+      const client = new TelegramClient(session, apiId, apiHash, {
+        connectionRetries: 5,
+      });
+
+      try {
+        await client.connect();
+        if (await client.checkAuthorization()) {
+          const me = await client.getMe();
+          console.log("\n✅ Already authenticated as:", me.firstName, me.lastName || "");
+          console.log("📞 Phone:", me.phone);
+          await client.disconnect();
+          process.exit(0);
+        }
+      } catch (e) {
+        console.log("Existing session invalid, re-authenticating...");
+      }
+    }
+  }
+
+  const session = new StringSession("");
+  const client = new TelegramClient(session, apiId, apiHash, {
+    connectionRetries: 5,
+  });
+
+  await client.connect();
+
+  if (!code) {
+    // Step 1: Send verification code
+    console.log(`\n📱 Sending verification code to ${phoneNumber}...`);
+
+    try {
+      const result = await client.invoke(
+        new Api.auth.SendCode({
+          phoneNumber: phoneNumber,
+          apiId: apiId,
+          apiHash: apiHash,
+          settings: new Api.CodeSettings({}),
+        })
+      );
+
+      // Save phone_code_hash for step 2
+      writeFileSync(PHONE_CODE_HASH_FILE, (result as any).phoneCodeHash, "utf-8");
+
+      console.log("\n✅ Verification code sent!");
+      console.log("Check your Telegram app for the code.");
+      console.log(`\nNext step: Run this command with the code:`);
+      console.log(`  doppler run --project seed --config prd -- bun run auth-verify.ts ${phoneNumber} <CODE>`);
+    } catch (e: any) {
+      console.error("\n❌ Error sending code:", e.message);
+    }
+  } else {
+    // Step 2: Sign in with code
+    console.log(`\n🔐 Signing in with code: ${code}...`);
+
+    let phoneCodeHash = "";
+    if (existsSync(PHONE_CODE_HASH_FILE)) {
+      phoneCodeHash = readFileSync(PHONE_CODE_HASH_FILE, "utf-8").trim();
+    }
+
+    if (!phoneCodeHash) {
+      console.error("❌ No phone_code_hash found. Run step 1 first (without code).");
+      process.exit(1);
+    }
+
+    try {
+      let result: any;
+
+      try {
+        result = await client.invoke(
+          new Api.auth.SignIn({
+            phoneNumber: phoneNumber,
+            phoneCodeHash: phoneCodeHash,
+            phoneCode: code,
+          })
+        );
+      } catch (e: any) {
+        if (e.message?.includes("SESSION_PASSWORD_NEEDED") || password) {
+          // 2FA required
+          if (!password) {
+            console.log("\n⚠️  2FA is enabled on this account.");
+            console.log("Please provide your 2FA password:");
+            console.log(`  doppler run --project seed --config prd -- bun run auth-verify.ts ${phoneNumber} ${code} "YOUR_PASSWORD"`);
+            process.exit(1);
+          }
+          // Get password info and sign in
+          const passwordInfo = await client.invoke(new Api.account.GetPassword({}));
+          result = await client.invoke(
+            new Api.auth.CheckPassword({
+              password: await client.computeCheck(passwordInfo as any, password),
+            })
+          );
+        } else {
+          throw e;
+        }
+      }
+
+      // Save session
+      const sessionString = client.session.save() as unknown as string;
+      writeFileSync(SESSION_FILE, sessionString, "utf-8");
+
+      console.log("\n✅ Successfully authenticated!");
+      console.log(`📁 Session saved to: ${SESSION_FILE}`);
+
+      // Get user info
+      const me = await client.getMe();
+      console.log(`👤 Logged in as: ${me.firstName} ${me.lastName || ""}`);
+      console.log(`📞 Phone: ${me.phone}`);
+      console.log(`👤 Username: @${me.username || "N/A"}`);
+
+    } catch (e: any) {
+      console.error("\n❌ Sign in error:", e.message);
+    }
+  }
+
+  await client.disconnect();
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/auth.js

@@ -0,0 +1,154 @@
+#!/usr/bin/env bun
+"use strict";
+/**
+ * Telegram Authentication Script
+ *
+ * Run this once to authenticate and generate a session string.
+ * The session will be saved to ~/.telegram-mcp/session.txt
+ *
+ * Usage:
+ *   bun run auth.ts
+ *
+ * Environment variables (from Doppler):
+ *   TELEGRAM_API_ID - Your Telegram API ID
+ *   TELEGRAM_API_HASH - Your Telegram API Hash
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+var telegram_1 = require("telegram");
+var sessions_1 = require("telegram/sessions");
+var readline_1 = require("readline");
+var os_1 = require("os");
+var path_1 = require("path");
+var fs_1 = require("fs");
+var SESSION_DIR = (0, path_1.join)((0, os_1.homedir)(), ".telegram-mcp");
+var SESSION_FILE = (0, path_1.join)(SESSION_DIR, "session.txt");
+// Ensure session directory exists
+if (!(0, fs_1.existsSync)(SESSION_DIR)) {
+    (0, fs_1.mkdirSync)(SESSION_DIR, { recursive: true });
+}
+var rl = readline_1.default.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+});
+var question = function (prompt) {
+    return new Promise(function (resolve) {
+        rl.question(prompt, resolve);
+    });
+};
+function main() {
+    return __awaiter(this, void 0, void 0, function () {
+        var apiId, apiHash, session, client, sessionString;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    apiId = parseInt(process.env.TELEGRAM_API_ID || "0");
+                    apiHash = process.env.TELEGRAM_API_HASH;
+                    if (!apiId || !apiHash) {
+                        console.error("ERROR: TELEGRAM_API_ID and TELEGRAM_API_HASH must be set");
+                        console.error("Run with: doppler run --project seed --config prd -- bun run auth.ts");
+                        process.exit(1);
+                    }
+                    console.log("\n📱 Telegram Authentication\n");
+                    console.log("This will authenticate your Telegram account and save a session.");
+                    console.log("You'll receive a verification code via Telegram.\n");
+                    session = new sessions_1.StringSession("");
+                    client = new telegram_1.TelegramClient(session, apiId, apiHash, {
+                        connectionRetries: 5,
+                    });
+                    return [4 /*yield*/, client.start({
+                            phoneNumber: function () { return __awaiter(_this, void 0, void 0, function () {
+                                var phone;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, question("Enter your phone number (with country code, e.g., +1234567890): ")];
+                                        case 1:
+                                            phone = _a.sent();
+                                            return [2 /*return*/, phone];
+                                    }
+                                });
+                            }); },
+                            password: function () { return __awaiter(_this, void 0, void 0, function () {
+                                var password;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, question("Enter your 2FA password (if enabled, press Enter to skip): ")];
+                                        case 1:
+                                            password = _a.sent();
+                                            return [2 /*return*/, password || ""];
+                                    }
+                                });
+                            }); },
+                            phoneCode: function () { return __awaiter(_this, void 0, void 0, function () {
+                                var code;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, question("Enter the verification code you received: ")];
+                                        case 1:
+                                            code = _a.sent();
+                                            return [2 /*return*/, code];
+                                    }
+                                });
+                            }); },
+                            onError: function (err) {
+                                console.error("Auth error:", err);
+                            },
+                        })];
+                case 1:
+                    _a.sent();
+                    rl.close();
+                    sessionString = client.session.save();
+                    (0, fs_1.writeFileSync)(SESSION_FILE, sessionString, "utf-8");
+                    console.log("\n✅ Successfully authenticated!");
+                    console.log("\uD83D\uDCC1 Session saved to: ".concat(SESSION_FILE));
+                    console.log("\uD83D\uDD11 Session string (backup): ".concat(sessionString.substring(0, 50), "..."));
+                    console.log("\nYou can now use the Telegram MCP server.");
+                    return [4 /*yield*/, client.disconnect()];
+                case 2:
+                    _a.sent();
+                    process.exit(0);
+                    return [2 /*return*/];
+            }
+        });
+    });
+}
+main().catch(function (err) {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/auth.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env bun
+/**
+ * Telegram Authentication Script
+ *
+ * Run this once to authenticate and generate a session string.
+ * The session will be saved to ~/.telegram-mcp/session.txt
+ *
+ * Usage:
+ *   bun run auth.ts
+ *
+ * Environment variables (from Doppler):
+ *   TELEGRAM_API_ID - Your Telegram API ID
+ *   TELEGRAM_API_HASH - Your Telegram API Hash
+ */
+
+import { TelegramClient } from "telegram";
+import { StringSession } from "telegram/sessions";
+import readline from "readline";
+import { homedir } from "os";
+import { join } from "path";
+import { mkdirSync, existsSync, writeFileSync } from "fs";
+
+const SESSION_DIR = join(homedir(), ".telegram-mcp");
+const SESSION_FILE = join(SESSION_DIR, "session.txt");
+
+// Ensure session directory exists
+if (!existsSync(SESSION_DIR)) {
+  mkdirSync(SESSION_DIR, { recursive: true });
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+const question = (prompt: string): Promise<string> => {
+  return new Promise((resolve) => {
+    rl.question(prompt, resolve);
+  });
+};
+
+async function main() {
+  const apiId = parseInt(process.env.TELEGRAM_API_ID || "0");
+  const apiHash = process.env.TELEGRAM_API_HASH;
+
+  if (!apiId || !apiHash) {
+    console.error("ERROR: TELEGRAM_API_ID and TELEGRAM_API_HASH must be set");
+    console.error("Run with: doppler run --project seed --config prd -- bun run auth.ts");
+    process.exit(1);
+  }
+
+  console.log("\n📱 Telegram Authentication\n");
+  console.log("This will authenticate your Telegram account and save a session.");
+  console.log("You'll receive a verification code via Telegram.\n");
+
+  const session = new StringSession("");
+
+  const client = new TelegramClient(session, apiId, apiHash, {
+    connectionRetries: 5,
+  });
+
+  await client.start({
+    phoneNumber: async () => {
+      const phone = await question("Enter your phone number (with country code, e.g., +1234567890): ");
+      return phone;
+    },
+    password: async () => {
+      const password = await question("Enter your 2FA password (if enabled, press Enter to skip): ");
+      return password || "";
+    },
+    phoneCode: async () => {
+      const code = await question("Enter the verification code you received: ");
+      return code;
+    },
+    onError: (err) => {
+      console.error("Auth error:", err);
+    },
+  });
+
+  rl.close();
+
+  // Save session
+  const sessionString = client.session.save() as unknown as string;
+  writeFileSync(SESSION_FILE, sessionString, "utf-8");
+
+  console.log("\n✅ Successfully authenticated!");
+  console.log(`📁 Session saved to: ${SESSION_FILE}`);
+  console.log(`🔑 Session string (backup): ${sessionString.substring(0, 50)}...`);
+  console.log("\nYou can now use the Telegram MCP server.");
+
+  await client.disconnect();
+  process.exit(0);
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});