mcpField
T
TwitterTools MCP

TwitterTools MCP

本地服务
twittertools.com社交媒体13 周前更新
代码仓库访问官网

关于 TwitterTools MCP

TwitterTools MCP 是面向 AI Agent 的 MCP 服务，可读取 X 公开帖子并按 X 规则处理文本。它兼有帖子与串文获取功能，以及离线 URL 解析、字符计数和串文拆分工具。

主要功能

  1. 01获取公开帖子及媒体 URL
  2. 02按顺序读取串文
  3. 03按 X 规则计数字符
  4. 04将文本拆成编号帖子
  5. 05解析帖子 URL 和 ID

适用场景

  1. 01通过 URL 查看公开帖子
  2. 02按顺序读取一组串文
  3. 03检查文本是否符合 X 字数限制
  4. 04将长文本整理为帖子串

MCP 相关

向 MCP 客户端提供五种工具，用于获取公开帖子和串文、解析 URL、计数字符及拆分文本。帖子数据通过配置的 twittertools.com API base 获取，其余三种工具可离线运行。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "steley-twittertools": {
      "command": "npx",
      "args": [
        "-y",
        "twittertools-mcp"
      ],
      "env": {
        "TWITTERTOOLS_API_BASE": "<TWITTERTOOLS_API_BASE>"
      }
    }
  }
}
启动命令npx -y twittertools-mcp
需要配置的环境变量
TWITTERTOOLS_API_BASEAPI base of a self-hosted twittertools instance (default: https://twittertools.com)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtwittertools-mcp1.2.2

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
url_or_idstring是帖子 URL（x.com 或 twitter.com）、纯数字 ID，或包含其中之一的文本

详细介绍

twittertools-mcp

Model Context Protocol 服务，适用于 TwitterTools — 将工具包带给 AI Agent （Claude、ChatGPT、Cursor、ZCode，等等）。无需登录、不追踪、不需要 API 密钥。 已列入官方 MCP Registry，名称为 io.github.steley/twittertools-mcp。

工具

工具功能
get_tweet通过 URL 或 ID 获取公开帖子：文本、作者、带直接 CDN URL 的媒体
get_thread按顺序展开线程中的帖子（部分结果会标记出来）
count_chars根据 X 的实际 280 字符限制统计文本（CJK 字符按 ×2 计算，链接按 23 个字符计算）
split_thread将长文本拆分为带编号且符合长度限制的帖子
parse_tweet_urlURL/ID → ID、作者账号、发布时间、规范永久链接

get_tweet / get_thread 会调用无状态的 twittertools.com API，该 API 通过 X 的免费 syndication 端点解析公开帖子。其余三个工具完全离线运行。媒体不会经过代理：推文结果包含直接的 pbs.twimg.com / video.twimg.com URL，任何客户端都可以自行获取。

此包没有任何依赖项：MCP 协议层是手工编写的 （通过标准输入/输出传输以换行符分隔的 JSON-RPC），因此整个供应链攻击面仅限于此目录中的几百行代码，可通过 Socket 或任何扫描器验证。

安装

# Claude Code
claude mcp add twittertools -- npx -y twittertools-mcp

或者，将其添加到任何读取 mcpServers 配置的客户端中 （Claude Desktop 的 claude_desktop_config.json、Cursor 的 .cursor/mcp.json，等等）：

{
  "mcpServers": {
    "twittertools": {
      "command": "npx",
      "args": ["-y", "twittertools-mcp"]
    }
  }
}

需要 Node 18+。

提示：npx 每次启动时都会从注册表解析最新版本 （缓存后立即完成，首次需要几秒钟）。如需消除启动延迟，可运行一次 npm i -g twittertools-mcp，并设置 "command": "twittertools-mcp"。

自托管

将 TWITTERTOOLS_API_BASE 指向你自己的 server/downloader_server.py 实例，即可让查找完全在你的基础设施上进行：

{ "command": "npx", "args": ["-y", "twittertools-mcp"], "env": { "TWITTERTOOLS_API_BASE": "https://your-instance.example" } }

隐私

此服务无状态：不存储任何内容、不收集遥测数据，也不需要账户。它只会与配置的 API 基础 URL 通信。该 API 按 IP 限流，且只保留汇总的匿名计数器 — 详见 twittertools.com/privacy。

开发

npm install
cd .. && npx vitest run mcp   # unit + stdio protocol tests (offline, mock API)

采用 MIT 许可证 — 与主项目相同。

评论

支持 Markdown

第一次接触 MCP？

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

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