FindMCP Logo FindMCP.info
Telegram MCP server

Telegram MCP server

site icon
2025.03.14 69
PythonTelegram API 集成AI 助手桥梁交流协作
mcp-telegram 是一个基于 Model Context Protocol (MCP) 的服务器，作为 Telegram API 与 AI 助手之间的桥梁。它提供了对 Telegram API 的只读访问功能，允许用户获取对话列表、未读消息等信息。该服务器适用于需要将 Telegram 数据与 AI 助手集成的场景，如消息摘要生成、联系人管理等。
View on GitHub

Overview

基本能力

产品定位

mcp-telegram 是一个连接 Telegram API 和 AI 助手的桥梁服务器，基于 Model Context Protocol (MCP)。

核心功能

  • 获取对话列表（聊天、频道、群组）
  • 获取指定对话中的（未读）消息列表
  • 创建未读消息的摘要
  • 查找特定主题的讨论并生成摘要

适用场景

  • 创建未读消息的摘要
  • 查找即将过生日的联系人并安排问候
  • 查找特定主题的讨论并生成摘要和链接列表

工具列表

  • mcp-telegram sign-in: 用于登录 Telegram API
  • mcp-telegram logout: 用于登出 Telegram API
  • uv run cli.py list-tools: 列出所有可用工具
  • uv run cli.py call-tool: 调用具体工具

常见问题解答

  • 问题: 'Could not connect to MCP server mcp-telegram' 解决方案: 检查配置文件中 uv 二进制文件的完整路径，或检查配置文件中克隆仓库的路径是否正确。

使用教程

使用依赖

安装教程

uv tool install git+https://github.com/sparfenyuk/mcp-telegram

调试方式

在终端中调试服务器

# 列出所有可用工具
uv run cli.py list-tools

# 调用具体工具
uv run cli.py call-tool --name ListDialogs --arguments '{"unread": true}'

在 Inspector 中调试服务器

npx @modelcontextprotocol/inspector uv run mcp-telegram

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。