Telegram MCP 服务器

Telegram MCP 服务器

为 Telegram 用户客户端 API 提供的 MCP 服务实现，支持 AI 助手交互。

GitHub
Created Bykfastovkfastov

快速入门

前置条件

  1. 安装 Node.js（推荐 18+ 版本）。
  2. 激活 Telegram 账户并启用两步验证。
  3. 在 Telegram API 获取 api_id 和 api_hash。

安装

  1. 克隆仓库： git clone https://github.com/kfastov/telegram-mcp-server.git cd telegram-mcp-server
  2. 安装依赖： npm install

配置

创建 .env 文件并设置以下内容： TELEGRAM_API_ID=YOUR_API_ID TELEGRAM_API_HASH=YOUR_API_HASH TELEGRAM_PHONE_NUMBER=YOUR_PHONE_NUMBER_WITH_COUNTRY_CODE

配置客户端软件（如 Claude Desktop）连接到服务器，修改其配置文件以包含： { "mcpServers": { "telegram": { "url": "http://localhost:8080/sse", "disabled": false } } }

启动

运行以下命令启动服务器： 首次登录时会提示输入验证码和密码： npm start

成功后将生成会话文件，用于免登录。

问题排查

  • 如果频繁要求登录，请检查 data/session.json 文件的有效性。
  • 缓存问题可删除 data/dialog_cache.json 并重启服务刷新。
  • 确保运行目录正确或使用绝对路径。