Qwen码电报MCP服务器
版本： v2.2.0版本
用于Telegram Bot与Qwen Code集成的MCP服务器。通过Telegram直接与Qwen Code聊天，具有持久会话、群聊支持和高级功能。
______________________________________________________________________
🌟 特性
核心功能
- 🤖 Telegram Bot集成 -通过长时间轮询的完整Telegram Bot API
- 🔌 MCP协议支持 -与Qwen代码的原生集成
- 💬 持久会话 -基于文件的对话历史记录（重新启动后仍然有效）
- 🔐 配对系统 -用于访问控制的6位代码安全
- ⌨️ 打字指示器 -处理时更好的用户体验
- 📊 管理员命令 -会话管理和监控
- 🧹 自动清理 -旧会话的自动维护
- 🔧 动态配置 -工作区特定设置
v2.2.0新功能
- 👥 群聊支持 -机器人在群组中工作，不会崩溃！
- 📢 基于提及的触发器 -Bot仅在被提及时响应(
@bot_name) - 💭 引用消息上下文 -机器人读取回复/引用消息
- 🔇 无声忽略 -群组中没有垃圾邮件（忽略未提及的内容）
- 🎯 智能回复 -自动回复原始消息以获得更好的用户体验
- 📈 指标跟踪 -请求计数和令牌使用监控
______________________________________________________________________
🚀 快速开始
适用于Qwen代码用户（Vibe编码）
🎯 最简单的方法： 让你的法学硕士代理处理一切！
克隆此存储库后，只需告诉您的Qwen代码：
@qwen Read and implement VIBE-INSTALL.md for installation,
then VIBE-CONFIG.md for configuration. Ask me for confirmation
before any sensitive data.您的法学硕士代理人将：
- ✅ 自动安装所有依赖项
- ✅ 构建TypeScript项目
- ✅ 指导您完成Telegram机器人创建
- ✅ 配置Qwen代码MCP设置
- ✅ 测试一切正常
📚 Vibe编码指南：
- 📦 振动安装.md -自动安装
- ⚙️ VIB-CONFIG.md -自动配置
- 🛠️ VIBE-REPAIR.md -自动故障排除
______________________________________________________________________
来自人类的特别说明 这是人类唯一接触过的部分。此MCP中的所有内容都是氛围编码的，但结构安全。 如果出了什么事，就去找你的经纪人。它会为你做复杂的事情。 想要新功能吗？问问你的经纪人。 我的经纪人扫清了道路。你的应该遵循。 -JavaIsKey
______________________________________________________________________
手动安装
先决条件
- Node.js>=18.x
- npm>=9.x
- Git
步骤
- 克隆存储库
git clone https://github.com/YOUR_USERNAME/qwen-code-telegram-mcp.git
cd qwen-code-telegram-mcp- 安装依赖项
npm install- 构建TypeScript
npm run build- 设置环境
cp .env.example .env
# Edit .env with your configuration- 配置Qwen代码
添加 ~/.qwen/settings.json:
{
"mcpServers": {
"telegram": {
"command": "node",
"args": ["[YOUR_PATH]/dist/index.js"],
"env": {
"TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}",
"WORKSPACE_PATH": "[YOUR_WORKSPACE_PATH]"
}
}
}
}- 启动Qwen代码
npx qwen- 在Telegram上与您的机器人聊天！
______________________________________________________________________
📱 电报机器人设置
创建新机器人
- 打开电报→ 搜索
@BotFather - 发送
/newbot - 遵循说明：
- 选择名称： My Assistant - 选择用户名： my_assistant_bot
- 复制机器人令牌 （格式：
123456789:ABCdef...)
⚠️ 重要提示：禁用隐私模式
如需群聊支持：
- @植物学家→
/setprivacy - 选择您的机器人
- 选择： “禁用隐私”
没有这个，机器人就不会阅读群消息！
______________________________________________________________________
🎮 用法
私聊
只需向机器人发送消息：
User: Hello
Bot: [AI response from Qwen Code]群聊
必须提及机器人：
User: @my_bot_name What's the capital of France?
Bot: [AI response]
User: hello everyone
Bot: [Ignored - no mention]引用消息：
User 1: [sends message] "This is important"
User 2: [reply] @my_bot_name summarize this
Bot: [Reads quoted message + instruction]______________________________________________________________________
📋 可用命令
用户命令
/start-欢迎留言+配对说明/help-帮助信息/status-服务器状态/session-您的会话信息/clear-清除会话/whoami-您的电报信息/ask-直接询问Qwen代码/pair-将机器人与代码配对/approvalmode [mode]-设置审批模式（计划/自动接受/yolo）
管理员命令
/sessions-列出所有活动会话
______________________________________________________________________
🔐 配对系统
运作原理
- 用户消息机器人 -机器人检查用户是否配对
- 管理员生成代码 -通过MCP工具：
generate_telegram_pairing_code- 用户对 -用户运行：
/pair ABC123- 访问已授权 -用户现在可以访问
配对代码属性
- 6个字符（大写字母数字）
- 有效期为15分钟
- 一次性使用
- 过期时自动清理
______________________________________________________________________
📁 项目结构
qwen-code-telegram-mcp/
├── src/
│ └── index.ts # Main code (2300+ lines)
├── dist/
│ └── index.js # Compiled code
├── .env # Environment config
├── .env.example # Example config
├── package.json # Dependencies
├── tsconfig.json # TypeScript config
├── README.md # This file
├── DOCUMENTATION.md # Detailed documentation
├── VIBE-INSTALL.md # LLM agent installation guide
├── VIBE-CONFIG.md # LLM agent configuration guide
└── VIBE-REPAIR.md # LLM agent troubleshooting guide
Workspace/
├── temp/
│ ├── telegram-bot.log # Runtime log
│ └── telegram-sessions/
│ ├── {chatId}.json # User sessions
│ ├── allowlist.json # Paired users
│ └── approval-modes.json # Approval modes
└── .qwen/
└── commands/
└── *.md # Custom commands______________________________________________________________________
⚙️ 配置
环境变量
复制 .env.example 到 .env 并配置：
# Telegram Bot Configuration
TELEGRAM_BOT_TOKEN=your_bot_token_here
# Workspace Configuration
WORKSPACE_PATH=/path/to/your/workspace
# MCP Server Configuration
MCP_SERVER_PORT=3000
MCP_TRANSPORT=stdio会话设置
| 设置 | 默认值 | 说明 |
|---|---|---|
MAX_CONVERSATION_HISTORY | 50 | 每个会话的最大消息数 |
INACTIVE_CHAT_TIMEOUT_MS | 86400000 | 会话到期（24小时） |
______________________________________________________________________
🛠️ 发展
# Build TypeScript
npm run build
# Run development mode
npm run dev
# Run production
npm start______________________________________________________________________
🐛 故障排除
Bot没有响应
检查：
- 机器人令牌有效吗？ → @植物学家
- 机器人在Qwen代码中运行？
- 隐私模式已禁用？ →
/setprivacy
会话未保存
检查：
WORKSPACE_PATH对的？- 文件夹是否具有写入权限？
temp/telegram-sessions/存在？
配对代码不起作用
检查：
- 代码未过期（仅15分钟）
- 正确输入的代码（大写）
- 用户在allowlist中？
需要帮助？
👉 看 VIBE-REPAIR.md 获取全面的故障排除指南！
______________________________________________________________________
📊 指标跟踪
Bot自动跟踪：
totalRequests-邮件总数totalErrors-错误计数tokens.total-估计令牌使用量tokens.prompt-输入令牌tokens.output-输出令牌
查看方式： /status 命令
______________________________________________________________________
🧪 测试检查表
基本功能
- \[\]DM：
hello→ AI响应 - \[\]组：
@bot_name test→ AI响应 - \[\]组：
test（未提及）→ 忽略 - \[\]自定义命令：
/health→ 已执行
会话
- \[\]会话文件已创建
- \[\]重新启动后会话仍然存在
- \[ \]
/clear删除会话 - \[ \]
/session显示正确信息
配对
- \[\]未播出→ 访问被拒绝
- \[\]生成代码→ Works
- \[ \]
/pair ABC123→ 成功 - \[\]无效代码→ 拒绝
文件
- \[\]发送文档→ 已处理
- \[\]发送照片→ 已下载
- \[ \]
send_telegram_file→ Works
日志记录
- \[\]日志文件已创建
- \[\]已记录的消息
- \[\]记录错误
- \[\]没有无限循环
______________________________________________________________________
📝 版本历史记录
v2.2.0（当前）
- ✅ 全群聊支持
- ✅ 基于提及的触发
- ✅ 引用消息上下文
- ✅ 电报自动更正处理
- ✅ 指标跟踪
v2.1
- 通过特定于工作区的MCP配置支持多机器人
v2.0
- 持续会话
- 配对系统
- 打字指示器
- 管理员命令
v1.0
- 带有基本MCP集成的初始版本
______________________________________________________________________
📚 文档
- 振动安装.md -LLM代理安装指南
- VIB-CONFIG.md -LLM代理配置指南
- VIBE-REPAIR.md -LLM代理故障排除指南
- 文件.md -详细的技术文档
- 贡献.md -贡献指南
- 代码_OF_CONDUCT.md -行为守则
______________________________________________________________________
🤝 贡献
欢迎投稿！请阅读 贡献.md 第一。
快速贡献
- Fork存储库
- 创建分支：
git checkout -b feature/your-feature - 进行更改
- 彻底测试
- 提交PR
______________________________________________________________________
📄 许可证
ISC许可证-请参阅 许可证 文件。
______________________________________________________________________
🆘 支持
问题：
- 检查 VIBE-REPAIR.md 第一
- 审核日志：
temp/telegram-bot.log - 使用以下命令创建GitHub问题：
- 错误信息 - 你刚才在做什么 - 您的环境（Node.js、操作系统）
如有疑问：
- 创建GitHub讨论
- 检查 文件.md
______________________________________________________________________
🎯 为什么选择Vibe编码？
该项目旨在 Qwen Code氛围编码:
- ✅ LLM友好设置 -VIBE-\*自动化安装指南
- ✅ 零配置 -LLM代理处理一切
- ✅ 智能故障排除 -VIBE-REAIR用于自动修复
- ✅ 用户确认 -敏感数据需要用户批准
- ✅ 证据充分的 -每一步都解释清楚
只需克隆，让你的LLM代理来做这项工作！ 🚀
______________________________________________________________________
*内置于❤️ Qwen代码*\ *最后更新时间：2026-03-26*