Telegram MCP Server

Telegram MCP Server

site icon
2025.04.07 0
TypeScriptTelegram 消息服务AI 助手集成交流协作
Telegram MCP Server 是一个基于 Model Context Protocol (MCP) 的服务,允许通过 AI 助手(如 Claude Desktop)发送 Telegram 消息。它提供了一个清晰且安全的方式,让 AI 助手能够与本地服务和 API 交互,同时保持用户控制。
View on GitHub

Overview

基本能力

产品定位

Telegram MCP Server 是一个连接 AI 助手与 Telegram 消息服务的桥梁,使得 AI 助手能够通过 MCP 协议发送消息到 Telegram。

核心功能

  • 实现 MCP 协议,支持 AI 助手与 Telegram 的交互
  • 提供 send_telegram_message 工具,用于发送消息到 Telegram

适用场景

  • 通过 AI 助手自动发送消息到 Telegram
  • 集成 AI 助手与 Telegram 进行自动化交流

工具列表

  • send_telegram_message: 发送消息到配置的 Telegram 聊天
  • 参数: message (string): 要发送的消息文本

常见问题解答

  • 需要配置 Telegram Bot API token 和聊天 ID
  • 配置信息存储在 .cursor/mcp.json 文件中

使用教程

使用依赖

  1. 确保已安装 Node.js 环境
  2. 安装项目依赖:
npm install

安装教程

  1. 克隆项目并安装依赖
  2. 构建项目:
npm run build
  1. 配置环境变量 TELEGRAM_TOKENCHAT_ID
  2. .cursor/mcp.json 中配置服务器信息

调试方式

  1. 确保配置正确
  2. 启动服务器:
node ./dist/mcp-server.js
  1. 通过 AI 助手测试消息发送功能

许可证

该项目遵循 MIT 开源许可条款。