MCP电报

@dryeab/mcp-telegram

0 Stars 365 次浏览 dryeab 更新于 2026-08-23

语言类型：英语翻译结果：MCP Telegram服务器

交流协作工具

该服务暂未提供标准配置，请参考 README 手动接入

服务介绍

通过 Model Context Protocol (MCP) 将大型语言模型连接到 Telegram。

该服务器基于 Telethon 构建，允许 AI 代理与 Telegram 交互，支持发送/编辑/删除消息、搜索聊天记录、管理草稿、下载媒体等功能，使用的是 MTProto 协议。

🚀 开始使用
- 先决条件
- 安装
⚙️ 使用方法
- 登录
- 连接到 MCP 服务器
🧰 可用工具
🛠️ 故障排除
🤝 贡献
📝 许可证

🚀 开始使用

先决条件

Python 3.10 或更高版本
uv 请按照官方 uv 指南进行安装。

安装

安装 mcp-telegram 命令行工具：

uv tool install mcp-telegram

⚙️ 使用方法

[!IMPORTANT]
在使用此工具之前，请确保您已阅读并理解 Telegram 的服务条款 (ToS)。滥用此工具可能导致账户被限制。

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

mcp-telegram --help # See all commands

连接到 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>"
      }
    }
  }
}

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

macOS: ~/Library/Application Support/Claude/ 或 ~/.cursor/

Windows: %APPDATA%\Claude\ 或 %APPDATA%\Cursor\

[!IMPORTANT]
如果您的客户端无法执行 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`	📸 从消息中下载照片、视频和文档

[!Note]
有关详细参数信息和示例用法，请在终端中运行 mcp-telegram tools。

🛠️ 故障排除

数据库锁定错误

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

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

macOS / Linux: pkill -f "mcp-telegram"
Windows: taskkill /F /IM mcp-telegram.exe /T（请在任务管理器中检查确切的进程名称）

🤝 贡献

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

📝 许可证

此项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。

查看源码项目主页