telegram-mcp-local-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Telegram MCP Server
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,298 @@
+# Telegram MCP Local Server
+
+Простой MCP (Model Context Protocol) сервер для работы с Telegram. Позволяет получать список чатов, историю сообщений и отправлять сообщения через Telegram API.
+
+## Возможности
+
+- 🔌 Подключение к Telegram через API
+- 💬 Получение списка чатов
+- 📜 Получение истории сообщений из чатов
+- 📤 Отправка сообщений
+- 🔄 Работа через stdio (для интеграции с MCP-совместимыми клиентами)
+- 🔒 Режим "только чтение" (readonly) для безопасной работы
+
+## Установка
+
+### Через npx (рекомендуется)
+
+Вы можете запустить сервер напрямую без установки:
+
+```bash
+npx telegram-mcp-local-server
+```
+
+Или установить глобально:
+
+```bash
+npm install -g telegram-mcp-local-server
+telegram-mcp-local-server
+```
+
+### Для разработки
+
+```bash
+git clone <repository-url>
+cd telegram-mcp-server
+npm install
+npm run build
+```
+
+## Получение Telegram API ключей
+
+1. Перейдите на https://my.telegram.org/
+2. Войдите в свою учетную запись Telegram
+3. Перейдите в раздел "API development tools"
+4. Создайте новое приложение и получите `api_id` и `api_hash`
+
+## Использование
+
+### Запуск сервера
+
+```bash
+# Через npx
+npx telegram-mcp-local-server
+
+# Или если установлен глобально
+telegram-mcp-local-server
+
+# Для разработки
+npm start
+# или
+npm run dev
+```
+
+### Режим "только чтение" (Readonly Mode)
+
+Для безопасной работы сервер можно запустить в режиме "только чтение", в котором доступны только функции чтения (получение чатов и истории сообщений), а отправка сообщений заблокирована.
+
+```bash
+# Через npx
+TELEGRAM_READONLY_MODE=true npx telegram-mcp-local-server
+
+# Или если установлен глобально  
+TELEGRAM_READONLY_MODE=true telegram-mcp-local-server
+
+# Для разработки
+TELEGRAM_READONLY_MODE=true npm start
+# или
+TELEGRAM_READONLY_MODE=true npm run dev
+```
+
+В readonly режиме доступны только следующие инструменты:
+- `telegram_connect` - подключение к Telegram
+- `telegram_get_chats` - получение списка чатов  
+- `telegram_get_chat_history` - получение истории сообщений
+
+Инструмент `telegram_send_message` недоступен в readonly режиме.
+
+### Доступные инструменты
+
+#### `telegram_connect`
+Подключение к Telegram с использованием API ключей.
+
+Параметры:
+- `apiId` (обязательно): Telegram API ID
+- `apiHash` (обязательно): Telegram API Hash
+- `sessionString` (опционально): Строка сессии для авторизации
+
+#### `telegram_get_chats`
+Получение списка чатов.
+
+Параметры:
+- `limit` (опционально): Максимальное количество чатов (по умолчанию: 50)
+
+#### `telegram_get_chat_history`
+Получение истории сообщений из конкретного чата.
+
+Параметры:
+- `chatId` (обязательно): ID чата или username
+- `limit` (опционально): Максимальное количество сообщений (по умолчанию: 50)
+- `offsetId` (опционально): ID сообщения для начала (для пагинации)
+
+#### `telegram_send_message`
+Отправка сообщения в конкретный чат.
+
+Параметры:
+- `chatId` (обязательно): ID чата или username
+- `message` (обязательно): Текст сообщения
+
+## Пример использования
+
+```javascript
+// Подключение к Telegram
+{
+  "name": "telegram_connect",
+  "arguments": {
+    "apiId": "your_api_id",
+    "apiHash": "your_api_hash"
+  }
+}
+
+// Получение списка чатов
+{
+  "name": "telegram_get_chats",
+  "arguments": {
+    "limit": 20
+  }
+}
+
+// Получение истории сообщений
+{
+  "name": "telegram_get_chat_history", 
+  "arguments": {
+    "chatId": "@username",
+    "limit": 100
+  }
+}
+
+// Отправка сообщения
+{
+  "name": "telegram_send_message",
+  "arguments": {
+    "chatId": "@username",
+    "message": "Привет!"
+  }
+}
+```
+
+## Настройка аутентификации
+
+Для работы с Telegram API необходимо получить строку сессии:
+
+### Способ 1: Использование утилиты session-helper
+
+```bash
+npm run session
+```
+
+Следуйте инструкциям в интерактивном режиме:
+1. Введите API ID и Hash
+2. Введите номер телефона
+3. Введите код из SMS
+4. При необходимости введите пароль двухфакторной аутентификации
+5. Скопируйте полученную строку сессии
+
+### Способ 2: Вручную
+
+```bash
+npm run test-client
+```
+
+Эта команда запустит интерактивный тест клиента для получения сессии.
+
+## Тестирование
+
+### Тест основного функционала
+
+```bash
+npm run example
+```
+
+Эта команда покажет доступные инструменты и примеры использования.
+
+### Интерактивный тест
+
+```bash
+npm run test-client
+```
+
+Интерактивный тест, который поможет проверить подключение и основные функции.
+
+## Настройка MCP клиента
+
+Для использования с MCP-совместимыми клиентами (например, Claude Desktop), добавьте в конфигурацию:
+
+### Через npx (рекомендуется)
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "npx",
+      "args": ["telegram-mcp-local-server"],
+      "env": {
+        "TELEGRAM_API_ID": "your_api_id",
+        "TELEGRAM_API_HASH": "your_api_hash",
+        "TELEGRAM_SESSION_STRING": "your_session_string",
+        "TELEGRAM_READONLY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+### Через глобальную установку
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "telegram-mcp-local-server",
+      "env": {
+        "TELEGRAM_API_ID": "your_api_id",
+        "TELEGRAM_API_HASH": "your_api_hash", 
+        "TELEGRAM_SESSION_STRING": "your_session_string",
+        "TELEGRAM_READONLY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+### Локальная установка
+
+```json
+{
+  "mcpServers": {
+    "telegram": {
+      "command": "node",
+      "args": ["dist/index.js"],
+      "cwd": "/path/to/telegram-mcp-server",
+      "env": {
+        "TELEGRAM_API_ID": "your_api_id",
+        "TELEGRAM_API_HASH": "your_api_hash",
+        "TELEGRAM_SESSION_STRING": "your_session_string",
+        "TELEGRAM_READONLY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+**Примечание**: Установите `TELEGRAM_READONLY_MODE=true` для безопасного режима только чтения.
+
+## Структура проекта
+
+```
+src/
+├── index.ts          # Основной MCP сервер
+└── telegram-client.ts # Клиент для работы с Telegram API
+```
+
+## Зависимости
+
+- `@modelcontextprotocol/sdk` - SDK для MCP
+- `telegram` - Библиотека для работы с Telegram API
+- `zod` - Валидация параметров
+
+## Разработка
+
+Для разработки и внесения изменений см. [CONTRIBUTING.md](CONTRIBUTING.md).
+
+### Быстрый старт для разработчиков
+
+```bash
+git clone <repository-url>
+cd telegram-mcp-server
+npm install
+npm run build
+npm test
+```
+
+### Автоматическая публикация
+
+Проект использует GitHub Actions для автоматической публикации в npm при изменениях в main ветке.
+
+## Лицензия
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+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":""}

package/dist/index.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ErrorCode, ListToolsRequestSchema, McpError, } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { TelegramClient } from "./telegram-client.js";
+const server = new Server({
+    name: "telegram-mcp-server",
+    version: "0.1.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Telegram client instance
+let telegramClient = null;
+// Check if server is running in readonly mode
+const isReadonlyMode = process.env.TELEGRAM_READONLY_MODE === 'true';
+// Initialize Telegram client
+async function initializeTelegramClient(apiId, apiHash, sessionString) {
+    if (!telegramClient) {
+        telegramClient = new TelegramClient({
+            apiId: parseInt(apiId),
+            apiHash,
+            sessionString,
+        });
+        await telegramClient.connect();
+    }
+    return telegramClient;
+}
+// Auto-initialize Telegram client if environment variables are present
+async function autoInitializeTelegramClient() {
+    const apiId = process.env.TELEGRAM_API_ID;
+    const apiHash = process.env.TELEGRAM_API_HASH;
+    const sessionString = process.env.TELEGRAM_SESSION_STRING;
+    if (apiId && apiHash) {
+        try {
+            await initializeTelegramClient(apiId, apiHash, sessionString);
+            console.log(`Telegram client auto-initialized from environment variables (${isReadonlyMode ? 'readonly' : 'read-write'} mode)`);
+        }
+        catch (error) {
+            console.warn("Failed to auto-initialize Telegram client:", error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const tools = [
+        {
+            name: "telegram_connect",
+            description: "Connect to Telegram using API credentials",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    apiId: {
+                        type: "string",
+                        description: "Telegram API ID",
+                    },
+                    apiHash: {
+                        type: "string",
+                        description: "Telegram API Hash",
+                    },
+                    sessionString: {
+                        type: "string",
+                        description: "Optional session string for authentication",
+                    },
+                },
+                required: ["apiId", "apiHash"],
+            },
+        },
+        {
+            name: "telegram_get_chats",
+            description: "Get list of chats from Telegram",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    limit: {
+                        type: "number",
+                        description: "Maximum number of chats to retrieve (default: 50)",
+                    },
+                },
+            },
+        },
+        {
+            name: "telegram_get_chat_history",
+            description: "Get message history from a specific chat",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    chatId: {
+                        type: "string",
+                        description: "Chat ID or username",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "Maximum number of messages to retrieve (default: 50)",
+                    },
+                    offsetId: {
+                        type: "number",
+                        description: "Message ID to start from (for pagination)",
+                    },
+                },
+                required: ["chatId"],
+            },
+        },
+    ];
+    // Add send message tool only if not in readonly mode
+    if (!isReadonlyMode) {
+        tools.push({
+            name: "telegram_send_message",
+            description: "Send a message to a specific chat",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    chatId: {
+                        type: "string",
+                        description: "Chat ID or username",
+                    },
+                    message: {
+                        type: "string",
+                        description: "Message text to send",
+                    },
+                },
+                required: ["chatId", "message"],
+            },
+        });
+    }
+    return { tools };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "telegram_connect": {
+                const connectSchema = z.object({
+                    apiId: z.string(),
+                    apiHash: z.string(),
+                    sessionString: z.string().optional(),
+                });
+                const { apiId, apiHash, sessionString } = connectSchema.parse(args);
+                try {
+                    await initializeTelegramClient(apiId, apiHash, sessionString);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "Successfully connected to Telegram",
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Failed to connect to Telegram: ${error instanceof Error ? error.message : String(error)}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            case "telegram_get_chats": {
+                if (!telegramClient) {
+                    throw new McpError(ErrorCode.InvalidRequest, "Telegram client not initialized. Please connect first using telegram_connect.");
+                }
+                const chatsSchema = z.object({
+                    limit: z.number().optional().default(50),
+                });
+                const { limit } = chatsSchema.parse(args);
+                try {
+                    const chats = await telegramClient.getChats(limit);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(chats, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Failed to get chats: ${error instanceof Error ? error.message : String(error)}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            case "telegram_get_chat_history": {
+                if (!telegramClient) {
+                    throw new McpError(ErrorCode.InvalidRequest, "Telegram client not initialized. Please connect first using telegram_connect.");
+                }
+                const historySchema = z.object({
+                    chatId: z.string(),
+                    limit: z.number().optional().default(50),
+                    offsetId: z.number().optional(),
+                });
+                const { chatId, limit, offsetId } = historySchema.parse(args);
+                try {
+                    const messages = await telegramClient.getChatHistory(chatId, limit, offsetId);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(messages, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Failed to get chat history: ${error instanceof Error ? error.message : String(error)}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            case "telegram_send_message": {
+                if (isReadonlyMode) {
+                    throw new McpError(ErrorCode.InvalidRequest, "Message sending is not available in readonly mode.");
+                }
+                if (!telegramClient) {
+                    throw new McpError(ErrorCode.InvalidRequest, "Telegram client not initialized. Please connect first using telegram_connect.");
+                }
+                const sendSchema = z.object({
+                    chatId: z.string(),
+                    message: z.string(),
+                });
+                const { chatId, message } = sendSchema.parse(args);
+                try {
+                    const result = await telegramClient.sendMessage(chatId, message);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                catch (error) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Failed to send message: ${error instanceof Error ? error.message : String(error)}`,
+                            },
+                        ],
+                    };
+                }
+            }
+            default:
+                throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            throw new McpError(ErrorCode.InvalidParams, `Invalid parameters: ${error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join(', ')}`);
+        }
+        throw error;
+    }
+});
+async function runServer() {
+    // Auto-initialize Telegram client if environment variables are present
+    await autoInitializeTelegramClient();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.log(`Telegram MCP server running on stdio (${isReadonlyMode ? 'readonly' : 'read-write'} mode)`);
+}
+runServer().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/telegram-client.d.ts

@@ -0,0 +1,33 @@
+export interface TelegramConfig {
+    apiId: number;
+    apiHash: string;
+    sessionString?: string;
+}
+export interface ChatInfo {
+    id: string;
+    title: string;
+    type: string;
+    username?: string;
+    participantsCount?: number;
+}
+export interface MessageInfo {
+    id: number;
+    text: string;
+    date: Date;
+    fromId?: string;
+    fromUsername?: string;
+    fromFirstName?: string;
+    fromLastName?: string;
+    replyToMsgId?: number;
+}
+export declare class TelegramClient {
+    private client;
+    private config;
+    constructor(config: TelegramConfig);
+    connect(): Promise<void>;
+    getChats(limit?: number): Promise<ChatInfo[]>;
+    getChatHistory(chatId: string, limit?: number, offsetId?: number): Promise<MessageInfo[]>;
+    sendMessage(chatId: string, message: string): Promise<MessageInfo>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=telegram-client.d.ts.map

package/dist/telegram-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-client.d.ts","sourceRoot":"","sources":["../src/telegram-client.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,cAAc;IAS5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxB,QAAQ,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA+CjD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA0D7F,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BlE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAKlC"}

package/dist/telegram-client.js

@@ -0,0 +1,136 @@
+import { TelegramClient as TgClient } from "telegram";
+import { StringSession } from "telegram/sessions/index.js";
+export class TelegramClient {
+    constructor(config) {
+        this.config = config;
+        const session = new StringSession(config.sessionString || "");
+        this.client = new TgClient(session, config.apiId, config.apiHash, {
+            connectionRetries: 5,
+        });
+    }
+    async connect() {
+        console.error("Connecting to Telegram...");
+        await this.client.connect();
+        console.error("Connected to Telegram successfully");
+    }
+    async getChats(limit = 50) {
+        console.error(`Fetching ${limit} chats...`);
+        const dialogs = await this.client.getDialogs({ limit });
+        const chats = [];
+        for (const dialog of dialogs) {
+            const entity = dialog.entity;
+            if (!entity)
+                continue;
+            let chatInfo;
+            if (entity.className === "User") {
+                chatInfo = {
+                    id: entity.id.toString(),
+                    title: `${entity.firstName || ""} ${entity.lastName || ""}`.trim(),
+                    type: "user",
+                    username: entity.username,
+                };
+            }
+            else if (entity.className === "Chat") {
+                chatInfo = {
+                    id: entity.id.toString(),
+                    title: entity.title,
+                    type: "group",
+                    participantsCount: entity.participantsCount,
+                };
+            }
+            else if (entity.className === "Channel") {
+                chatInfo = {
+                    id: entity.id.toString(),
+                    title: entity.title,
+                    type: entity.broadcast ? "channel" : "supergroup",
+                    username: entity.username,
+                    participantsCount: entity.participantsCount,
+                };
+            }
+            else {
+                continue; // Skip unknown entity types
+            }
+            chats.push(chatInfo);
+        }
+        console.error(`Fetched ${chats.length} chats`);
+        return chats;
+    }
+    async getChatHistory(chatId, limit = 50, offsetId) {
+        console.error(`Fetching ${limit} messages from chat ${chatId}...`);
+        try {
+            const entity = await this.client.getEntity(chatId);
+            const messages = await this.client.getMessages(entity, {
+                limit,
+                offsetId,
+            });
+            const messageInfos = [];
+            for (const message of messages) {
+                const msg = message;
+                if (!msg || msg.className !== "Message") {
+                    continue;
+                }
+                let fromUsername;
+                let fromFirstName;
+                let fromLastName;
+                if (msg.fromId) {
+                    try {
+                        const sender = await this.client.getEntity(msg.fromId);
+                        if (sender?.className === "User") {
+                            fromUsername = sender.username;
+                            fromFirstName = sender.firstName;
+                            fromLastName = sender.lastName;
+                        }
+                    }
+                    catch (error) {
+                        console.error("Error getting sender info:", error);
+                    }
+                }
+                const messageInfo = {
+                    id: msg.id,
+                    text: msg.message || "",
+                    date: new Date(msg.date * 1000),
+                    fromId: msg.fromId?.toString(),
+                    fromUsername,
+                    fromFirstName,
+                    fromLastName,
+                    replyToMsgId: msg.replyTo?.replyToMsgId,
+                };
+                messageInfos.push(messageInfo);
+            }
+            console.error(`Fetched ${messageInfos.length} messages`);
+            return messageInfos;
+        }
+        catch (error) {
+            console.error(`Error fetching chat history for ${chatId}:`, error);
+            throw error;
+        }
+    }
+    async sendMessage(chatId, message) {
+        console.error(`Sending message to chat ${chatId}...`);
+        try {
+            const entity = await this.client.getEntity(chatId);
+            const result = await this.client.sendMessage(entity, { message });
+            if (!result || result.className !== "Message") {
+                throw new Error("Failed to send message");
+            }
+            const messageInfo = {
+                id: result.id,
+                text: result.message || "",
+                date: new Date(result.date * 1000),
+                fromId: result.fromId?.toString(),
+            };
+            console.error("Message sent successfully");
+            return messageInfo;
+        }
+        catch (error) {
+            console.error(`Error sending message to ${chatId}:`, error);
+            throw error;
+        }
+    }
+    async disconnect() {
+        console.error("Disconnecting from Telegram...");
+        await this.client.disconnect();
+        console.error("Disconnected from Telegram");
+    }
+}
+//# sourceMappingURL=telegram-client.js.map

package/dist/telegram-client.js.map

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

package/dist/test.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

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

package/dist/test.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { TelegramClient } from "./telegram-client.js";
+import * as readline from "readline";
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+});
+function question(query) {
+    return new Promise((resolve) => {
+        rl.question(query, resolve);
+    });
+}
+async function main() {
+    try {
+        console.log("=== Telegram MCP Server Test ===\n");
+        const apiId = await question("Enter your Telegram API ID: ");
+        const apiHash = await question("Enter your Telegram API Hash: ");
+        const sessionString = await question("Enter your session string (or press Enter to skip): ");
+        console.log("\nConnecting to Telegram...");
+        const client = new TelegramClient({
+            apiId: parseInt(apiId),
+            apiHash,
+            sessionString: sessionString || undefined,
+        });
+        await client.connect();
+        console.log("\n=== Testing chat list ===");
+        const chats = await client.getChats(10);
+        console.log(`Found ${chats.length} chats:`);
+        chats.forEach((chat, index) => {
+            console.log(`${index + 1}. ${chat.title} (${chat.type}) - ID: ${chat.id}`);
+        });
+        if (chats.length > 0) {
+            const chatIndex = await question(`\nSelect chat number (1-${chats.length}) to get history: `);
+            const selectedChat = chats[parseInt(chatIndex) - 1];
+            if (selectedChat) {
+                console.log(`\n=== Getting history for ${selectedChat.title} ===`);
+                const messages = await client.getChatHistory(selectedChat.id, 5);
+                console.log(`Found ${messages.length} messages:`);
+                messages.forEach((msg, index) => {
+                    console.log(`${index + 1}. [${msg.date.toLocaleString()}] ${msg.fromFirstName || 'Unknown'}: ${msg.text.substring(0, 100)}${msg.text.length > 100 ? '...' : ''}`);
+                });
+            }
+        }
+        await client.disconnect();
+        console.log("\nTest completed successfully!");
+    }
+    catch (error) {
+        console.error("Test failed:", error);
+    }
+    finally {
+        rl.close();
+    }
+}
+main();
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "telegram-mcp-local-server",
+  "version": "1.0.0",
+  "description": "MCP server for Telegram integration. Allows reading chat lists, message history, and sending messages through Telegram API.",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "telegram-mcp-local-server": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE",
+    "session-helper.js"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "test": "jest",
+    "test-client": "tsx src/test.ts",
+    "session": "node session-helper.js",
+    "example": "node example.js",
+    "test-readonly": "node test-readonly.js",
+    "prepublishOnly": "npm run build",
+    "version:patch": "node scripts/bump-version.js patch",
+    "version:minor": "node scripts/bump-version.js minor",
+    "version:major": "node scripts/bump-version.js major"
+  },
+  "keywords": ["mcp", "telegram", "server", "model-context-protocol", "ai", "llm", "chat", "messaging"],
+  "author": "Your Name <your.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/telegram-mcp-local-server.git"
+  },
+  "homepage": "https://github.com/yourusername/telegram-mcp-local-server#readme",
+  "bugs": {
+    "url": "https://github.com/yourusername/telegram-mcp-local-server/issues"
+  },
+
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "telegram": "^2.24.10",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.6.0",
+    "typescript": "^5.3.0",
+    "jest": "^29.7.0",
+    "@types/jest": "^29.5.8",
+    "ts-jest": "^29.1.1"
+  }
+}

package/session-helper.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+// Утилита для получения строки сессии Telegram
+const { TelegramClient } = require('telegram');
+const { StringSession } = require('telegram/sessions');
+const readline = require('readline');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function question(query) {
+  return new Promise((resolve) => {
+    rl.question(query, resolve);
+  });
+}
+
+async function main() {
+  console.log('=== Telegram Session Helper ===\n');
+  console.log('Эта утилита поможет вам получить строку сессии для MCP сервера.');
+  console.log('Для этого вам понадобятся API ключи с https://my.telegram.org/\n');
+
+  try {
+    const apiId = await question('Введите ваш API ID: ');
+    const apiHash = await question('Введите ваш API Hash: ');
+
+    console.log('\nПодключение к Telegram...');
+    
+    const stringSession = new StringSession('');
+    const client = new TelegramClient(stringSession, parseInt(apiId), apiHash, {
+      connectionRetries: 5,
+    });
+
+    await client.start({
+      phoneNumber: async () => await question('Введите ваш номер телефона (с кодом страны): '),
+      password: async () => await question('Введите ваш пароль двухфакторной аутентификации: '),
+      phoneCode: async () => await question('Введите код из SMS: '),
+      onError: (err) => console.error('Ошибка:', err),
+    });
+
+    console.log('\n✅ Успешно подключены к Telegram!');
+    
+    const sessionString = client.session.save();
+    console.log('\n🔑 Ваша строка сессии:');
+    console.log(`"${sessionString}"`);
+    
+    console.log('\n📝 Используйте эту строку сессии в параметре sessionString при вызове telegram_connect');
+    console.log('⚠️  Храните эту строку в безопасном месте и не делитесь ей с другими!');
+
+    await client.disconnect();
+    
+  } catch (error) {
+    console.error('Ошибка:', error.message);
+  } finally {
+    rl.close();
+  }
+}
+
+main();