Telegram MCP Server

⚠️ 这是 Telegram MCP Server 的通知工具 用于向用户的 Telegram Bot 发送任务进度通知 ❌ 这不是通用的 Telegram 消息发送工具 ❌ 不能发送消息到任意 Telegram 用户或群组 ✅ 只能发送通知到配置的 Telegram Bot（用户会在 Telegram 中收到） 💡 推荐使用 telegram_notify_with_actions 代替此工具 telegram_notify_with_actions 提供动态按钮，用户体验更好 此工具适用于： - 简单的状态更新（不需要用户交互） - 快速通知（无需提供下一步建议） - 向后兼容旧代码 参数： - event: 事件类型（completed/error/question/progress） - summary: 简短总结（必填，200字以内） - details: 详细信息（可选） 示例： telegram_notify( event="completed", summary="修复了 auth.py:45 的空指针异常，所有测试通过" ) 💡 更好的选择：使用 telegram_notify_with_actions 提供智能建议按钮

⭐ 推荐：发送带有动态操作按钮的智能通知到 Telegram ⚠️ 这是 Telegram MCP Server 的通知工具（增强版） 用于向用户的 Telegram Bot 发送任务进度通知，并提供智能操作建议 ❌ 这不是通用的 Telegram 消息发送工具 ❌ 不能发送消息到任意 Telegram 用户或群组 ✅ 只能发送通知到配置的 Telegram Bot（用户会在 Telegram 中收到） 这是 telegram_notify 的增强版本，可以根据当前情况为用户提供智能的下一步操作建议。 优势： - ✅ 提供 2-4 个智能操作按钮，用户一键执行 - ✅ 按钮是建议，不强制，用户可以忽略 - ✅ 自动添加提示："💡 这些是建议的下一步，你也可以直接发送其他指令" - ✅ 即使不提供按钮（actions=[]），也可以正常使用 参数： - event: 事件类型（completed/error/question/progress） - summary: 简短总结（必填，200字以内） - details: 详细信息（可选，建议填写） - actions: 操作按钮列表（可选，最多 4 个） actions 格式： [ { "text": "按钮显示文字", "action": "用户点击后发送的指令", "emoji": "可选的 emoji" } ] 使用场景： 1. 任务完成 - 提供下一步建议： telegram_notify_with_actions( event="completed", summary="✅ 完成用户认证模块\n- 实现登录/注册\n- JWT验证\n- 15个测试通过", details="修改文件：auth.py, user.py\n测试覆盖率：95%", actions=[ {"text": "实现权限管理", "action": "继续实现权限管理模块，包括角色和权限分配", "emoji": "💡"}, {"text": "优化性能", "action": "优化数据库查询性能，添加缓存层", "emoji": "⚡"} ] ) 2. 遇到错误 - 提供解决方案： telegram_notify_with_actions( event="error", summary="❌ 导入错误\nModuleNotFoundError: No module named 'jwt'", details="缺少 PyJWT 依赖包", actions=[ {"text": "自动修复", "action": "运行 pip install PyJWT 并重试", "emoji": "🔧"}, {"text": "添加到依赖", "action": "将 PyJWT 添加到 requirements.txt", "emoji": "📝"}, {"text": "显示错误代码", "action": "显示出错位置的代码", "emoji": "🔍"} ] ) 3. 需要决策 - 提供选项： telegram_notify_with_actions( event="question", summary="❓ 数据库选择\n需要选择数据库方案", details="方案A：PostgreSQL - 功能强大\n方案B：SQLite - 简单轻量", actions=[ {"text": "PostgreSQL（推荐）", "action": "使用 PostgreSQL，我会配置 docker-compose", "emoji": "1️⃣"}, {"text": "SQLite", "action": "使用 SQLite，适合小型项目", "emoji": "2️⃣"} ] ) 按钮设计原则： - 明确具体："💡 优化这 3 处性能瓶颈" 而不是 "优化" - 标记推荐：用 💡 标记推荐选项，但不强迫用户选择 - 数量适中：最多 4 个按钮，避免选择困难 - 可选性：用户可以忽略按钮，直接发送其他指令 注意： - 按钮是建议，不是强制选择 - 如果没有明确的下一步，可以不提供按钮（actions=[]） - 消息末尾会自动添加提示："💡 这些是建议的下一步，你也可以直接发送其他指令" - 简单确认或自动进行的过程不需要按钮

等待用户回复（阻塞式轮询） 参数： - max_wait: 最长等待时间（秒），默认604800（7天/1周） 行为： - 前10分钟：每30秒检查一次 - 10分钟-1小时：每60秒检查一次 - 1小时以上：每120秒检查一次 - 用户可以按 Ctrl+C 中断等待 - 超时返回 timeout: true 返回： - reply: 用户回复内容 - timeout: 是否超时 - interrupted: 是否被用户中断

发送自由格式消息到 Telegram（不推荐，请优先使用 telegram_notify） 自动处理： - 超过300字自动截断 - 会提示使用 telegram_notify 发送结构化消息

发送代码段到 Telegram（带语法高亮） ⚠️ 使用场景（仅在必要时使用）： - 遇到关键错误需要展示问题代码 - 修复了重要 bug，需要展示修复方案 - 用户明确要求查看某段代码 - 需要用户 review 关键代码片段 ❌ 不要使用的场景： - 一般性任务完成（使用 telegram_notify） - 创建了新文件（使用 telegram_send_file） - 例行操作（使用 telegram_notify 总结即可） 参数： - code: 代码内容（建议不超过50行） - language: 编程语言（python/javascript/go/rust/bash/json/yaml等） - caption: 可选说明文字（建议填写，解释发送这段代码的原因） 示例： telegram_send_code( code="def hello():\n print('Hello')", language="python", caption="修复了空指针异常的关键函数" )