Telegram News Aggregator

MCP文档知识

提供方 JoseTapiaUex

文档知识 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个完整的系统,用于从Telegram群组收集、处理和显示内容。

一句话选型结论

按资料字段整理

Telegram News Aggregator 属于文档知识类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

新闻聚合Python本地部署Telegram集成内容管理自动化处理WebAPI

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python -m venv venv

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Telegram News Aggregator当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JoseTapiaUex上游标注的维护方 JoseTapiaUex
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.9 KB
来自项目仓库与上游目录的原文,未做删改

Telegram新闻聚合器

从Telegram群组收集、处理和展示内容的完整系统。

📁 项目结构```

telegram-news-aggregator/
├── README.md
├── requirements.txt
├── .env.example
├── config.py
├── src/
│ ├── agent/
│ │ ├── init.py
│ │ ├── telegram_agent.py
│ │ └── content_processor.py
│ ├── backend/
│ │ ├── init.py
│ │ ├── app.py
│ │ └── database.py
│ └── frontend/
│ ├── index.html
│ ├── styles.css
│ └── script.js
└── data/
└── posts.db (se genera automáticamente)


## 🚀 安装

### 1. 克隆仓库```bash
git clone
cd telegram-news-aggregator

2. 创建虚拟环境```bash

python -m venv venv
source venv/bin/activate # En Windows: venv\Scripts\activate


### 3. 安装依赖项```bash
pip install -r requirements.txt

注`requirements.txt` 文件包含了核心依赖项以及为实现完整功能(如图像生成、快速解析等)所建议的可选依赖项。如果你在 Windows 上遇到编译错误(特别是与 lxml),请参阅下面的故障排除部分。

可用的帮助脚本:

  • scripts/setup_windows.ps1用于Windows上稳健安装的自动化脚本
  • scripts/test_generate_image.py图像生成功能测试脚本

4. 运行系统

选项1:自动化脚本(推荐用于Windows)```powershell

.\run_system.ps1


#### 选项2:手动执行```bash
# Activar entorno virtual
.venv\Scripts\activate  # Windows
# source .venv/bin/activate  # Linux/Mac

# Ejecutar
python run.py

⚙️ 设置

Telegram的MCP服务器

该项目假定你已经配置并运行了服务器 telegram-mcp。
在启动代理之前,请确保其正在运行。

环境变量(.env)

  • TELEGRAM_GROUP_NAME要监控的Telegram群组/频道名称
  • IMAGE_API_KEY用于生成图像的API密钥(可选)
  • IMAGE_API_URL图像生成服务的URL
  • CHECK_INTERVAL检查新消息的间隔时间(秒)(默认:300)
  • DATABASE_PATHSQLite数据库路径(默认:data/posts.db)
  • FLASK_PORTFlask 服务器的端口(默认:5000)

🎯 使用

1. 启动后端(Flask API)```bash

python src/backend/app.py


服务器将在 `http://localhost:5000`

### 2. 启动Telegram代理```bash
python src/agent/telegram_agent.py

特工将开始监控Telegram群组,并处理新的URL。

3. 访问前端界面

在你的浏览器中打开:```
http://localhost:5000


## 📡 API 接口端点

创建一篇新帖子```json
{
"title": "Título del post",
"summary": "Resumen breve del contenido",
"source_url": "https://ejemplo.com/articulo",
"image_url": "https://ejemplo.com/imagen.jpg",
"release_date": "2025-10-05",
"provider": "Nombre del Proveedor",
"type": "Artículo de Blog"
}

获取 /api/posts(资源)

获取所有帖子```json
{
"posts": [
{
"id": 1,
"title": "...",
"summary": "...",
...
}
]
}


通过ID获取特定帖子

## 🔧 组件

### Telegram代理(`telegram_agent.py`)

- 连接到Telegram的MCP服务器
- 从上次运行恢复消息
- 在消息中识别URL
- 内容处理外包

### 内容处理器(`content_processor.py`)

- 从URL中提取信息(标题、摘要、图片)
- 在没有可用图像时生成图像
- 整理帖子数据

### 后端 Flask(`app.py`)

- 用于管理帖子的REST API
- 前端已启用CORS
- 数据验证

### 数据库(`database.py`)

- SQLite用于本地存储
- “帖子”表的管理
- CRUD操作

### 前端

- **styles.css(样式表文件)**响应式与现代设计
- **script.js(通常可直接译为“脚本.js”,在编程或网页开发语境中,它指的是一个JavaScript脚本文件)**与API交互,动态渲染

## 🛠️ 技术

- **Python 3.8或更高版本**
- **Flask(一个轻量级的Web应用框架,常用于Python开发)**网络框架
- **SQLite**数据库
- **BeautifulSoup4**网络爬虫(或网页抓取)
- **请求:**HTTP 客户端
- **MCP(模型上下文协议)**与Telegram集成

## 📝 重要笔记

1. 服务器 `telegram-mcp` 在启动代理之前,它必须已经在运行
1. 数据库在首次启动时自动创建
1. 代理保存最后一次执行的时间戳以避免重复
1. 前端每30秒自动重新加载

## 🐛 故障排除

### 错误:“无法连接到MCP服务器”

- 检查 telegram-mcp 是否正在运行
- 检查进程的PID

### 错误:“未找到Telegram群组”

- 检查.env文件中的名称
- 确保机器人可以访问该群组

### 错误:“图片API无响应”

- 验证你的API密钥
- 检查服务的URL

### Windows:构建wheel时出错(lxml / Microsoft C++ 构建工具)

- 在安装依赖项时,如果你看到类似以下的错误:```
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools"

这意味着 pip 尝试编译一个依赖项(例如 lxml) 并且没有找到适用于你版本的Python/Windows的预编译轮子(wheel)。

  • 建议:运行准备好的脚本 scripts/setup_windows.ps1 从PowerShell(以管理员身份)。脚本将尝试:
  1. 更新 pip/setuptools/wheel
  2. 安装依赖项时优先使用二进制轮子
  3. 使用(某种方法/工具)进行回退 pip 正常
  4. 如果失败,请尝试安装 lxml 通过 pipwin (预编译的轮子)
  5. 如果一切失败,建议通过安装Visual C++构建工具 winget 或下载安装程序

要运行它:```powershell

Abre PowerShell como Administrador

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
.\scripts\setup_windows.ps1
```

如果你不想运行脚本,请按照上一节中关于安装Visual C++构建工具的说明操作,或者下载预编译的轮子以 lxml。

📄 许可证

MIT 许可证 - 您可以自由使用和修改此项目。

🤝 贡献

欢迎贡献。请先打开一个议题来讨论较大的更改。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Telegram News Aggregator 怎么安装?

在客户端按下面的安装命令接入:python -m venv venv。装完在客户端配置里引用同一个包或端点。

Telegram News Aggregator 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Telegram News Aggregator 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Telegram News Aggregator 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Telegram News Aggregator 能提供哪些能力?

资料显示能力标签包括 新闻聚合、知识管理、Python、自动化处理。具体工具清单以官方文档为准。

Telegram News Aggregator 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Telegram News Aggregator 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。