Telegram Bot MCP Server
为 AI 助手连接 Telegram Bot,支持富文本、多媒体消息和交互按钮,可自行部署。
telegram-bot-mcp-server 通过 MCP(模型上下文协议)让兼容客户端使用你自己的 Telegram Bot。服务运行在你控制的环境中,Bot 凭据由你配置和保管。
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @cyuanxv/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
MCP_API_KEY=<secret> TELEGRAM_BOT_TOKEN=<secret> TELEGRAM_CHAT_ID=<secret> claude mcp add io.github.cyuanxv-telegram-bot-mcp-server -- npx -y @cyuanxv/telegram-bot-mcp-server@1.0.1รันในเทอร์มินัล
{ "mcpServers": { "io.github.cyuanxv-telegram-bot-mcp-server": { "command": "npx", "args": [ "-y", "@cyuanxv/[email protected]" ], "env": { "MCP_API_KEY": "<secret>", "TELEGRAM_BOT_TOKEN": "<secret>", "TELEGRAM_CHAT_ID": "<secret>" } } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด需要 Node.js 24,先设置自己的 MCP_API_KEY 进程环境,再运行:
npx --yes @cyuanxv/[email protected] --port 3000
首次启动会编译源码。连接地址为 http://127.0.0.1:3000/api/mcp,使用 Streamable HTTP,并携带 Authorization: Bearer <你的 MCP_API_KEY>。真实发送还需你自己的 Bot token 和目标 chat ID。
各功能的配置要求见功能说明。本仓库提供后端源码,不包含 Sites 网页入口、Docker 镜像或预装依赖。本项目并非 Telegram 官方产品。
© 2026 cyuanxv · X / Twitter @cyuanxv
以下为源码开发方式;日常安装请优先看上面的 npm 教程。使用 Node.js 24 和随附的 npm。解压后所有后端命令都在 server/ 目录执行,不要在本包根目录执行 npm ci。
cd telegram-bot-mcp-server/server
npm ci --ignore-scripts
cp .env.example .env.local
# 用编辑器填 MCP_API_KEY;有自己的测试 Bot 时再填 token 和 chat ID
npm run dev -- --hostname 127.0.0.1
MCP 地址:http://127.0.0.1:3000/api/mcp。客户端请求需带 Authorization: Bearer <你的 MCP_API_KEY>。云端客户端通常不能访问你的本机地址,需要你自行部署 HTTPS 后端。
没有真实 Bot 也能启动并运行合成测试,但不能据此声称已向 Telegram 发出消息。不要把 Bot token、MCP 密钥或验证码贴入聊天、截图或 Git。
在 server/:
npm test
npm run test:review
npm run typecheck
npm run build:delivery
npm run build
npm run test:protocol
低内存设备可用 node --test-concurrency=2 --experimental-test-module-mocks --import ./tests/register-typescript.mjs --test tests/*.test.mjs 代替 npm test。协议检查只连接本机,端口3130须空闲;运行时不要加载真实 Bot 配置。
已有本地安装验收不等于云端部署、真实 Bot 或客户端效果验收。
MCP 密钥只给可信操作者:基础接口包含发送、编辑和管理工具,可选择原始 chat ID,配置别名不是完整的收件人白名单。不要把它作为无需认证的公开消息服务。
© 2026 cyuanxv · X / Twitter @cyuanxv
自有代码采用 MIT 许可证,第三方依赖保留各自的版权和许可。
Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.
{ "mcpServers": { "io.github.cyuanxv-telegram-bot-mcp-server": { "command": "npx", "args": [ "-y", "@cyuanxv/[email protected]" ], "env": { "MCP_API_KEY": "<secret>", "TELEGRAM_BOT_TOKEN": "<secret>", "TELEGRAM_CHAT_ID": "<secret>" } } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ผู้เผยแพร่ระบุตัวแปรสภาพแวดล้อมเหล่านี้: MCP_API_KEY, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID
Telegram Bot MCP Server ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-09 Self-hosted Telegram Bot MCP server for rich text, media and interactive buttons.