tg MCP

](https://python.org)  ](https://github.com/leshchenko1979/fast-mcp-telegram) 

快速MCP电报服务器 -Telegram集成了API直接访问、强大的搜索和人工智能助手的高级消息。

尝试演示

1. 打开https://tg-mcp.l1979.ru/setup并完成身份验证
2. 从设置页面复制您的Bearer令牌

然后选择你的道路：

MCP客户端（人工智能助手）

• 下载 mcp.json 文件
• 将服务器添加到您的AI客户端，并询问：“向我在电报中保存的消息发送问候”

直接API（卷曲）

• 运行以下命令（将TOKEN替换为您的命令）：

curl -X POST "https://tg-mcp.l1979.ru/mtproto-api/messages.SendMessage" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"params": {"peer": "me", "message": "Hello!"}}'

特性

快速开始

1.安装并验证

uvx --from fast-mcp-telegram fast-mcp-telegram-setup \
  --api-id="your_api_id" \
  --api-hash="your_api_hash" \
  --phone-number="+123456789"

会话存储在 ~/.config/fast-mcp-telegram/.

2.配置MCP客户端

stdio模式（本地）：

{
  "mcpServers": {
    "telegram": {
      "command": "uvx",
      "args": ["fast-mcp-telegram"],
      "env": {
        "API_ID": "your_api_id",
        "API_HASH": "your_api_hash"
      }
    }
  }
}

http身份验证模式（远程）： 看 安装指南 用于部署自己的服务器并通过web界面进行身份验证。

3.开始使用

{"tool": "search_messages_globally", "params": {"query": "hello", "limit": 5}}
{"tool": "get_messages", "params": {"chat_id": "me", "limit": 10}}
{"tool": "send_message", "params": {"chat_id": "me", "message": "Hello!"}}

部署到远程服务器

在VDS上部署自己的MCP服务器——请参阅 安装指南 获取分步说明。

可用工具

看 工具参考 有关详细文档和示例。

HTTP MTProto网桥

直接卷曲访问任何Telegram API方法 --可用于程序集成。

curl -X POST "https://tg-mcp.l1979.ru/mtproto-api/messages.SendMessage" \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"params": {"peer": "me", "message": "Hello from curl!"}}'

支持任何Telegram方法、自动实体解析和TL对象构造。

集成示例：

• CI/CD：向Telegram频道发送部署通知
• 监控：将警报和系统指标推送到管理员组
• Webhooks：接收外部事件并转发到Telegram
• 备份：将聊天记录导出到外部存储系统
• 自定义机器人：通过外部服务扩展功能

看 MTProto大桥 获取完整文档。

文档

• 安装指南 -本地设置和远程服务器部署
• 工具参考 -完整的工具文档
• MTProto大桥 -通过curl直接访问API
• 贡献 -贡献者指南
• 安全 -安全功能和最佳实践

许可证

MIT许可证-请参阅 许可证