mcpField
T
Telegram MCP Server

Telegram MCP Server

本地服务
github.com/kfastov通信协作441 周前更新
代码仓库

关于 Telegram MCP Server

tgcli 是一个 Telegram 命令行工具，支持后台同步，并可选择启用 MCP 服务。它基于 MTProto 操作个人账户而非 Bot API，适合希望在命令行或 AI 客户端中管理个人 Telegram 消息的用户。

主要功能

  1. 01命令行收发消息与搜索
  2. 02后台实时同步与归档回填
  3. 03消息与频道列表查询
  4. 04支持 --json 机器可读输出
  5. 05可选的 MCP 服务

适用场景

  1. 01在本地归档并搜索 Telegram 消息
  2. 02通过命令行发送文本或文件
  3. 03让 MCP 客户端访问个人 Telegram 数据

MCP 相关

启用后，tgcli server 会在本地地址（默认 http://127.0.0.1:8080/mcp）提供 MCP 端点，供 MCP 客户端连接。

#telegram#mcp#telegram-client#ai-agents#mcp-server#fastmcp#client-library

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

tgcli

Telegram 命令行工具，支持后台同步，并可选提供个人账户的 MCP 服务（MTProto，而非 Bot API）。

安装

npm install -g @kfastov/tgcli

brew install kfastov/tap/tgcli

身份验证

获取 Telegram API 凭据：

  1. 前往 https://my.telegram.org/apps
  2. 使用你的电话号码登录
  3. 创建一个新应用
  4. 复制 api_id 和 api_hash

然后进行身份验证：

tgcli auth

快速开始

tgcli auth
tgcli sync --follow
tgcli messages list --chat @username --limit 20
tgcli messages search "course" --chat @channel --source archive
tgcli send text --to @username --message "hello"
tgcli server

命令

tgcli auth           Authentication and session setup
tgcli config         View and edit config
tgcli sync           Archive backfill and realtime sync
tgcli server         Run background sync service (MCP optional)
tgcli service        Install/start/stop/status/logs for background service
tgcli channels       List/search channels
tgcli messages       List/search messages
tgcli send           Send text or files
tgcli media          Download media
tgcli topics         Forum topics
tgcli tags           Channel tags
tgcli metadata       Channel metadata cache
tgcli contacts       Contacts and people
tgcli groups         Group management
tgcli doctor         Diagnostics and sanity checks

使用 tgcli [command] --help 查看详情。添加 --json 可输出机器可读的内容。

MCP（可选）

通过配置启用：

tgcli config set mcp.enabled true

默认情况下，服务会绑定到 http://127.0.0.1:8080/mcp。如需更改：

tgcli config set mcp.host 127.0.0.1
tgcli config set mcp.port 8080

然后运行 tgcli server，并将你的客户端指向配置的地址。

配置与存储

tgcli 存储位于操作系统的应用数据目录中，包含 config.json、会话和 messages.db。 使用 TGCLI_STORE 覆盖存储位置。

旧版：请参阅 MIGRATION.md。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。