AI导哈

Telegram LLM控制工具

通过Model Context Protocol (MCP)连接大型语言模型与Telegram，实现消息发送/编辑/删除、聊天搜索、草稿管理、媒体下载等功能。

  • by dryeab
  • Python
  • 本地部署
  • 254 星标
  • 更新于
在 GitHub 查看 dryeab/mcp-telegram

使用说明

Enable LLMs to control your Telegram

通过以下方式将大型语言模型连接到Telegram 模型上下文协议（MCP）.

内置于 电视募捐，此服务器允许AI代理与Telegram交互，使用 MTProto.

Table of Contents

🚀 入门指南

先决条件

安装

安装 mcp-telegram CLI工具：

uv tool install mcp-telegram

⚙️ 用法

[！重要] 请确保您已阅读并理解Telegram的 服务类型 在使用此工具之前。滥用此工具可能会导致帐户限制。

这 mcp-telegram 命令行工具是您的切入点。

mcp-telegram --help # See all commands

登录

首先，使用您的Telegram帐户进行身份验证：

mcp-telegram login

此交互式命令将提示您：

  • API ID和API哈希： 从以下来源获取这些 my.telegram.org/apps.
  • 电话号码： 您的Telegram注册电话号码（国际格式，例如。， +1234567890).
  • 验证码： 首次登录时发送到您的Telegram帐户。
  • 2FA密码： 如果您启用了双因素身份验证。

您的凭据安全地存储在会话文件中以供将来使用。

[！警告] 将API证书保密，切勿公开共享

[！注意] 使用 mcp-telegram logout 退出当前会话或 mcp-telegram clear-session 删除所有存储的会话数据。

连接到MCP服务器

要将MCP Telegram与Claude Desktop或Cursor等MCP客户端一起使用，您需要配置MCP服务器。配置过程因客户端和操作系统而异。

有关详细的设置说明，请参阅：

配置文件应包含：

{
  "mcpServers": {
    "mcp-telegram": {
      "command": "mcp-telegram" /* Use full path if client can't find the command (e.g. "/usr/local/bin/mcp-telegram"). See IMPORTANT section below for full path instructions. */,
      "args": ["start"],
      "env": {
        "API_ID": "<your_api_id>",
        "API_HASH": "<your_api_hash>"
      }
    }
  }
}

[！注意] 配置路径因操作系统和客户端而异。例如：

  • macOS： ~/Library/Application Support/Claude/ 或 ~/.cursor/
  • 窗户： %APPDATA%\Claude\ 或 %APPDATA%\Cursor\

[！重要] 如果您的客户无法执行 mcp-telegram 尽管它在终端中是可访问的，但请尝试使用可执行文件的完整路径。你可以通过运行找到它 which mcp-telegram （macOS/Linux）或 where mcp-telegram （Windows）在您的终端中。更换 command 使用完整路径配置中的值。

保存配置文件后，重新启动应用程序。

🧰 可用工具

以下是您可以通过MCP与Telegram交互的工具的完整列表：

📨 消息传递工具

工具 说明
send_message ✉️ 向任何用户、组或频道发送短信或文件
edit_message ✏️ 修改以前发送的消息的内容
delete_message 🗑️ 删除一条或多条消息
get_messages 📜 使用高级筛选选项检索邮件历史记录

🔍 搜索和导航

工具 说明
search_dialogs 🔎 按名称或用户名查找用户、组和频道
message_from_link 🔗 使用Telegram链接访问特定消息

📝 草案管理

工具 说明
get_draft 📋 查看任何聊天的当前消息草稿
set_draft ✍️ 创建或清除消息草稿

📂 媒体处理

工具 说明
media_download 📸 从邮件中下载照片、视频和文档

[！注意] 有关详细的参数信息和示例用例，请运行 mcp-telegram tools 在你的终端。

🛠️ 故障排除

数据库锁定错误

运行多个 mcp-telegram 实例使用 同一会话文件 造成 database is locked 由于Telethon的SQLite会话存储而导致的错误。确保一次只有一个实例使用会话文件。

Force-Stopping Existing Processes

如果您需要停止可能卡住的流程：

  • macOS/Linux： pkill -f "mcp-telegram"
  • 窗户： taskkill /F /IM mcp-telegram.exe /T （检查任务管理器以获取确切的进程名称）

🤝 贡献

我们欢迎捐款！如果您想帮助改进MCP Telegram，请随时提交问题、功能请求或拉取请求。您的反馈和贡献有助于使这个项目对每个人都更好。

📝 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

Made with ❤️ by Yeabsira Driba

相关 MCP