← 返回目录

X Reader MCP Server

社区

通用内容阅读器：从任意URL获取结构化内容（文章、视频、播客、推文等）。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 966 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+
凭据: 可选 API Key
许可证: MIT
最近提交: 11 天前
工具数: 4

50FMRS · D

该服务器为支持多平台的内容抓取提供了灵活的解决方案，集成简便。然而，它需要较多的可选依赖，且可能涉及登录状态，用户需注意风险。

最强项 · 文档质量 14/20 最弱项 · 可靠性 6/20

可靠性

6/20

安全与权限

8/20

维护活跃度

12/20

文档质量

14/20

安装易用性

10/20

查看各项评分依据

可靠性 6/20: 静态审查显示项目结构清晰，MCP服务器入口（mcp_server.py）存在，但未提供实际运行的CI或测试证据。README声称提供四个工具，但源码中未完全验证其行为。存在依赖（如Jina、Playwright、Telethon等）可能导致启动失败或运行不稳定。错误处理和边界条件未充分展示。因此，可靠性评分较低，因为关键路径的可复现性未得到验证。
安全与权限 8/20: 项目使用环境变量管理API密钥（如GROQ_API_KEY）和Telegram凭据，并提示用户自行配置，未发现硬编码密钥。Playwright保存登录会话用于平台抓取，但明确限制外部访问（如X_READER_ALLOW_EXTERNAL_SESSION_COOKIES）。没有发现恶意行为或数据泄露风险。但权限管理（如用户确认）和数据流披露不够详细，因此未达到满分。
维护活跃度 12/20: 仓库有MIT许可证，未归档，有952颗星，但开放式问题数为0，这可能是因为问题被快速关闭或未跟踪。没有看到版本发布或依赖更新记录。维护活动无法从静态文件完全确认，但项目活跃度看起来较高。综合来看，维护良好但存在治理和版本管理上的不足。
文档质量 14/20: README提供了详细的安装、使用、配置和平台支持说明，包括CLI、库、MCP服务器和Claude Code技能的使用方法。配置变量、依赖和错误排除（如登录命令）已列出。但缺少对工具参数、限制和成本（如API费用）的详细说明，故障排除部分不完整。文档整体可用，但存在隐藏假设。
安装易用性 10/20: 安装步骤清晰，提供了pip安装和本地clone安装选项，包括可选依赖（Telegram、browser）和Playwright安装。MCP服务器需要clone仓库并运行python mcp_server.py，提供了客户端配置示例。但配置过程可能较复杂，需要安装额外系统依赖（如ffmpeg），且未提供自动化安装脚本。端口/进程管理等未详细说明，因此评分中等。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络控制浏览器

适合谁

需要从多种来源提取内容的内容聚合器或AI代理。
希望快速获取社交媒体帖子或文章结构化内容的开发者和研究者。
使用Claude Code的用户，希望基于视频/播客进行AI分析。

不适合谁

需要实时流媒体或实时数据抓取的用户。
希望无需安装额外依赖（如ffmpeg、Playwright）即可使用开箱即用MCP服务器的用户。
需要处理需要登录的网站，且未配置会话保存的用户。

所需权限

读取URL并进行网络请求。
可选：通过x-reader login命令保存浏览器会话，用于访问受限内容。
可选：访问环境变量，如GROQ_API_KEY用于Whisper转录。
可选：写入本地文件（如收件箱JSON、Markdown输出）。

风险与副作用

抓取网站可能违反其服务条款。
保存的浏览器会话可能包含敏感信息；应妥善保护。
外部API（如Groq）使用可能有速率限制或成本。
内容可能受版权保护；请确保合法使用。

安装接入

准备工作

运行环境：Python 3.10+

TG_API_ID 可选密钥 Telegram API ID，仅在抓取 Telegram 内容时需要，从 https://my.telegram.org 获取。

TG_API_HASH 可选密钥 Telegram API Hash，仅在抓取 Telegram 内容时需要，从 https://my.telegram.org 获取。

GROQ_API_KEY 可选密钥 Groq API 密钥，仅在需要 Whisper 音视频转写时需要，从 https://console.groq.com/keys 免费获取。

其他可选配置项（4 个）

INBOX_FILE 可选收件箱 JSON 文件路径，默认 ./unified_inbox.，可自定义。

OUTPUT_DIR 可选 Markdown 输出目录，默认关闭。

OBSIDIAN_VAULT 可选 Obsidian 仓库路径，启用后写入 01-收集箱/x-reader-inbox.md。

X_READER_ALLOW_EXTERNAL_SESSION_COOKIES 可选设为 1 时允许 Jina 使用本地保存的 X 会话读取受限文章，默认关闭。

克隆仓库：git clone https://github.com/runesleo/x-reader.git
进入目录：cd x-reader
安装依赖：pip install -e ".[mcp]"
启动MCP服务器：python mcp_server.py
配置Claude Desktop：在配置文件中添加mcpServers，指定命令和参数。

claude_desktop_config.json

{
  "mcpServers": {
    "x-reader": {
      "command": "python",
      "args": ["/path/to/x-reader/mcp_server.py"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "x-reader": {
      "command": "python",
      "args": [
        "/path/to/x-reader/mcp_server.py"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add x-reader -- python /path/to/x-reader/mcp_server.py

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动 MCP 服务器后，在客户端工具列表中应能看到 read_url、read_batch、list_inbox 和 detect_platform 四个工具；调用 detect_platform 传入任意 URL，能返回平台名称即说明连接成功。

常见排障

1. 确保已安装Python 3.10或更高版本。
2. 对于视频转录，确保安装ffmpeg并设置GROQ_API_KEY。
3. 对于Playwright回退，运行playwright install chromium。
4. 检查网络连接，确保能访问目标URL。
5. 如果MCP连接失败，确认mcp_server.py路径正确且已安装依赖。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我读取这篇文章的内容：https://mp.weixin.qq.com/s/abc123
用 detect_platform 判断这个链接属于哪个平台：https://x.com/elonmusk/status/123456
同时抓取这两个链接的内容：https://url1.com 和 https://url2.com
列出我之前抓取过的内容（list_inbox）

工具能力 4

read_url 只读

获取任意URL的内容，返回统一结构化格式。

read_batch 只读

并发获取多个URL的内容。

list_inbox 只读

查看之前获取的内容列表。

detect_platform 只读

识别给定URL所属的平台。

使用场景

从公众号帖子、推文、YouTube视频等提取内容以供分析。

批量获取多个URL的内容。

从YouTube、Bilibili、播客获取转录文本。

将抓取的内容嵌入到Anthropic的Claude Code工作流中。

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

x-reader 是一个通用的内容读取器，支持从多个平台获取结构化内容。它采用三层架构：Python CLI/库用于基本内容抓取，Claude Code技能用于视频转录和AI分析，以及通过MCP服务器暴露为MCP工具。该服务器提供四个工具：read_url（获取任意URL）、read_batch（并发获取多个URL）、list_inbox（查看已获取内容）、detect_platform（识别URL平台）。支持平台包括YouTube、Bilibili、X/Twitter、微信公众号、小红书、Telegram、RSS、小宇宙、Apple播客等。对于视频，可使用yt-dlp字幕或Whisper转录；对于受限内容，使用Playwright浏览器回退。该项目使用MIT许可证。