AI导哈

Telegram MCP服务器

一个极简的Telegram机器人交互MCP服务器，提供基本的消息发送和获取历史记录功能，适合学习和轻量级使用。

  • by tensakulabs
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 tensakulabs/telegram-mcp

使用说明

电报mcp

A. 最小 用于通过MTProto进行Telegram机器人交互的MCP服务器——故意简单、易读、易于扩展。

正在寻找功能齐全的Telegram MCP服务器？ 结账 奇威尔/电报mcp --60多种工具，涵盖消息传递、群组、联系人、媒体、管理等。

这个项目采取了不同的方法： 两个工具，约150行服务器代码，零复杂度。 对于那些想了解MCP服务器如何与Telegram协同工作，或者只需要基本的机器人消息而不需要完整客户端开销的人来说，这是一个干净的起点。

为什么存在

  • 学习参考 --在5分钟内读取整个服务器
  • 叉子友好 --添加你需要的工具，没有你不需要的
  • 最小依赖性 --只有Telethon、MCP SDK和python dotenv

工具

工具 说明
send_message 向Telegram机器人发送消息并等待其回复
get_history 使用Telegram机器人获取消息历史记录

设置

1.获取Telegram API证书

  1. 首选 https://my.telegram.org/apps
  2. 使用您的电话号码登录
  3. 创建新应用程序（任何名称/描述）
  4. 复制 API ID 和 API哈希

2.安装并验证

# Install
pip install git+https://github.com/tensakulabs/telegram-mcp.git

# Set your credentials
export TELEGRAM_API_ID=12345678
export TELEGRAM_API_HASH=abcdef1234567890abcdef1234567890
export TELEGRAM_PHONE=+15551234567

# Run one-time authentication (sends a code to your Telegram app)
telegram-mcp-auth

3.配置您的MCP客户端

克劳德代码

增添 ~/.claude/settings.json:

{
  "mcpServers": {
    "telegram": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tensakulabs/telegram-mcp.git", "telegram-mcp"],
      "env": {
        "TELEGRAM_API_ID": "your-api-id",
        "TELEGRAM_API_HASH": "your-api-hash",
        "TELEGRAM_SESSION_DIR": "/path/to/session/dir"
      }
    }
  }
}

克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "telegram": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/tensakulabs/telegram-mcp.git", "telegram-mcp"],
      "env": {
        "TELEGRAM_API_ID": "your-api-id",
        "TELEGRAM_API_HASH": "your-api-hash",
        "TELEGRAM_SESSION_DIR": "/path/to/session/dir"
      }
    }
  }
}

本地开发

如果你已经克隆了repo：

{
  "mcpServers": {
    "telegram": {
      "command": "uv",
      "args": ["--directory", "/path/to/telegram-mcp", "run", "telegram-mcp"],
      "env": {
        "TELEGRAM_API_ID": "your-api-id",
        "TELEGRAM_API_HASH": "your-api-hash"
      }
    }
  }
}

配置

环境变量 必填 默认 说明
TELEGRAM_API_ID 是 - 您的电报API ID
TELEGRAM_API_HASH 是 - 您的Telegram API哈希
TELEGRAM_PHONE 仅授权 -- 用于身份验证的电话号码
TELEGRAM_ENV_PATH 否 自动检测 .env文件的路径
TELEGRAM_SESSION_DIR 否 工作目录 会话文件目录

运作原理

此服务器使用 模型上下文协议 将Telegram交互作为任何兼容MCP的AI客户端都可以使用的工具。在引擎盖下，它：

  1. 使用您的预认证会话通过MTProto连接到Telegram
  2. 以您的用户帐户向机器人发送消息
  3. 轮询回复并返回结构化JSON响应
  4. 每次操作后干净地断开连接

安全说明

  • 您的会话文件(telegram_user.session)包含身份验证令牌-- 永远不要承诺
  • 这 .gitignore 默认情况下排除会话文件
  • API凭证应通过环境变量传递，而不是硬编码
  • 此工具充当您的Telegram帐户-相应地处理它

发展

git clone https://github.com/tensakulabs/telegram-mcp.git
cd telegram-mcp
uv sync
uv run telegram-mcp

需求

许可证

麻省理工学院

相关 MCP