3 v0.2.0 更新于 2026-11-09

mcp-telegram-agent MCP Server

Full Telegram Bot control for AI agents via pure Bot API: zero login risk, one Bot Token.

适用客户端

本地客户端

Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

本地运行(pypi)

{
  "mcpServers": {
    "mcp-telegram-agent": {
      "command": "uvx",
      "args": [
        "mcp-telegram-agent"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

send_text_message

发送支持 Markdown/HTML 格式的文本,可附带内联按钮或自定义回复键盘。

send_local_document

发送任意本地文件(PDF、CSV、代码、日志、压缩包等)。

send_local_photo

发送图片文件,支持说明文字和内联按钮。

send_local_video

以原生播放器形式发送视频文件。

send_local_audio_or_voice

发送音乐文件或原生语音条。

send_media_album

将 2 到 10 张照片或视频打包成相册一次性发送。

send_poll

创建单选/多选投票或计分测验。

send_location

通过经纬度坐标发送地理位置。

send_contact

分享包含电话号码的联系人名片。

send_dice

发送骰子、篮球、足球或老虎机等动画表情。

send_chat_action

显示机器人临时状态(如输入中、上传中)。

edit_message_text

动态修改已发送消息的文本和键盘。

delete_message

删除指定的消息。