mcpField
X
x-reader-mcp

x-reader-mcp

远程服务
x-reader-mcp.roastedrants.workers.dev社交媒体04 天前更新
代码仓库访问官网

关于 x-reader-mcp

x-reader-mcp 是一个只读 MCP 服务，可将公开 X 帖子和完整 X Articles 转为 Markdown，供 AI 客户端读取。它会解析长文格式，并包含作者、互动数据、媒体和文章正文。

主要功能

  1. 01读取公开帖子与文章
  2. 02将内容整理为 Markdown
  3. 03提取作者、日期与互动数据
  4. 04提供图片及高质量视频链接
  5. 05附带投票和引用帖子信息

适用场景

  1. 01在聊天中阅读公开 X 帖子
  2. 02获取 X Article 的完整正文
  3. 03将帖子内容复制或下载为 Markdown

MCP 相关

该服务通过 Streamable HTTP MCP 端点提供 `read_x_post` 工具，客户端传入帖子链接或数字 ID，即可取得帖子及完整文章的 Markdown。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://x-reader-mcp.roastedrants.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

X Reader MCP

让 Claude（或 ChatGPT、Cursor 及任何 MCP 客户端）读取公开的 X 帖子和完整的 X 文章。 在聊天中粘贴帖子链接，AI 就会获取整洁的 Markdown：标题、作者、日期、互动数据、 正文、图片、最高画质的视频链接、投票、引用帖子，以及完整的长篇文章正文。

连接器 URL： https://x-reader-mcp.roastedrants.workers.dev/mcp（将其添加为自定义连接器，无需登录）

  • 免费：使用公开的 FxTwitter API，无需 X API 密钥
  • 轻量：零运行时依赖，约 17 KB，可在 Cloudflare Workers 免费计划上运行
  • 只读：仅读取公开帖子

我开发它的原因：其他推文 MCP 只会返回 X 文章的链接，从不返回正文。 这个工具会将 X 的文章格式（Draft.js）渲染为规范的 Markdown，包含标题、列表、 粗体／斜体、链接、代码块、图片和视频。

如果它为你节省了时间，可以请我喝杯咖啡 ☕

立即使用（无需安装）

  • 网页阅读器： https://x-reader-mcp.roastedrants.workers.dev
    粘贴帖子链接，预览内容，然后复制或下载 Markdown。
  • Claude / ChatGPT 连接器： 将 https://x-reader-mcp.roastedrants.workers.dev/mcp 添加为自定义连接器（无需登录），然后在聊天中粘贴任意帖子链接。

想要自己的副本？请在下方自行部署。

输出示例

# I built a free MCP that lets Claude read X Articles

**Author:** roastedrants (@roastedrants), 1,234 followers
**Posted:** 2026-10-21 15:08 UTC
**Engagement:** 150 likes, 12 reposts, 5 replies, 2 quotes, 1,300 bookmarks, 45,678 views
**Type:** X Article

---

## Why TweetSave was not enough

It only returned the **article link**, never the body.

1. Deploy it on [**Cloudflare**](https://workers.cloudflare.com)
2. Add the connector in Claude
3. Paste any post link

部署（约 5 分钟）

你需要 Node.js 22.18 或更高版本，以及一个免费的 Cloudflare 账户。

npm install
npx wrangler login      # opens the browser once
npm run deploy

Wrangler 会输出你的 URL，格式类似 https://x-reader-mcp.<your-subdomain>.workers.dev。

在任意浏览器中快速检查（手机也可以）：

https://x-reader-mcp.<your-subdomain>.workers.dev/read?url=https://x.com/<user>/status/<id>

连接

你的 MCP 端点是上面的 URL 加上 /mcp。

Claude 应用（网页、桌面、移动端）： 设置 → 连接器 → 添加自定义连接器 → 粘贴 /mcp URL。 然后在聊天中启用它，并粘贴任意帖子链接。

Claude Code：

claude mcp add --transport http x-reader https://x-reader-mcp.<your-subdomain>.workers.dev/mcp

ChatGPT： 设置 → 应用和连接器（开发者模式）→ 使用 /mcp URL 创建连接器，无需身份验证。

Cursor / 其他客户端： 添加远程服务，并设置 "url": "https://.../mcp"。

工具

工具输入返回内容
read_x_posturl：帖子 URL（x.com、twitter.com、mobile、fxtwitter...）或数字 ID帖子的 Markdown；如果是 X 文章，还会返回完整文章

其他端点：GET / 是网页阅读器，GET /read?url=... 返回纯 Markdown。

限制（如实说明）

  • 仅限公开帖子。私密账户和已删除的帖子会返回明确错误。
  • 不支持回复，也不支持完整的多帖串（FxTwitter 只会返回单条帖子）。
  • 无法解析单独的文章链接（x.com/i/article/...）；请粘贴分享该文章的帖子。
  • 依赖 FxTwitter 这一免费社区服务。如果服务不可用，工具会告知你。
  • 该端点是公开的。Cloudflare 免费计划每天允许 100,000 次请求，足以供个人使用。

开发

npm test          # offline tests with a sample article (no network)
npm run dev       # local server at http://localhost:8787
npm run typecheck

代码概览：src/index.ts（基于 Streamable HTTP 的无状态 MCP）、src/fxtwitter.ts（URL 解析和抓取）、 src/markdown.ts（帖子和 Draft.js 文章转 Markdown）、src/page.ts（网页阅读器页面）。

致谢

数据来自 FxTwitter / FxEmbed。请善待他们的服务器。 与 X Corp. 无关联。

由 @roastedrants 制作。请我喝杯咖啡 ☕

MIT 许可证

评论

支持 Markdown

第一次接触 MCP？

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

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