6551Team/opentwitter-mcp

opentwitter-mcp – AI 助手的 Twitter 数据服务器

什么是它 – 一个基于 FastMCP 的小型 HTTP/WebSocket 服务器，将 Twitter/X 数据（个人资料、推文、搜索、关注者事件、KOL 追踪、等）封装在简单的 API 后。 它 旨在于本地运行，然后作为 MCP (Model-Context-Protocol) 服务器添加到 AI 驱动的编程助手，例如 Claude, OpenClaw, Cursor, Zed, 等，以便助手可以针对 Twitter 提出自然语言查询并获得结构化结果。

关键能力

能力	如何公开
用户用户资料查询	get_twitter_user / get_twitter_user_by_id
用户的近期推文	get_twitter_user_tweets
关键词 / hashtag 搜索	search_twitter, search_twitter_advanced
实时关注者 / 取消关注者事件	get_twitter_follower_events (WebSocket push)
已删除推文检测	get_twitter_deleted_tweets
KOL-关注者发现	get_twitter_kol_followers
观察列表管理 (添加 / 删除 / 列出)	add_twitter_watch, delete_twitter_watch, get_twitter_watch
完整推文获取 (包括回复, 引用, 媒体)	get_twitter_tweet_by_id, get_twitter_quote_tweets_by_id, get_twitter_retweet_users_by_id

安装 & 启动

1. 获取 Token – 在 http://app.newsliquid.com/mcp 注册并复制 OPENNEWS_TOKEN。
2. 设置 Token – 无论是作为环境变量或在项目根目录下的 config.json 中：

   export OPENNEWS_TOKEN="<your-token>"   # macOS / Linux
   # Windows PowerShell
   $env:OPENNEWS_TOKEN = "<your-token>"
   

3. 运行服务器 – README 推荐使用 uv 构建工具 (一个现代的 Python-only 替代方案，用于 Poetry/venv)：

   uv --directory /path/to/twitter-mcp run twitter-mcp
   

   相同的指令可以嵌入到任何支持的 AI 客户端 (Claude Code, OpenClaw, Cursor, etc.) 的 MCP 配置中。

AI 助手如何与其通信

• 助手注册服务器为名为 twitter 的 MCP。
• 当你输入自然语言请求 (例如：“显示 @elonmusk 的 Twitter 资料” )，助手会调用相应的工具 (例如：get_twitter_user)。
• 结果会以 README 中定义的 JSON 结构返回 (用户对象, 推文对象, 事件数组, 等)。
• 对于实时监控，助手可以打开 WebSocket wss://ai.6551.io/open/twitter_wss?token=YOUR_TOKEN 并接收 JSON-RPC push 事件，例如 NEW_TWEET, NEW_FOLLOWER, DELETE, 等。

配置选项

变量	用途
OPENNEWS_TOKEN (必填)	6551 后端 API 的 Bearer token
TWITTER_API_BASE	覆盖默认的 REST 终端 (默认是 https://ai.6551.io)
TWITTER_MAX_ROWS	每次请求返回的最大项目数 (默认 100)

环境变量和 config.json 文件都支持; 环境变量优先于两者存在时。

支持的客户端 – README 列出了 Claude Code (claude mcp add twitter …) 和 OpenClaw (复制 skill directory) 的现成指令。 它 也 为许多编辑器 (Cursor, Zed, Continue.dev, etc.) 提供了 JSON/YAML 片段，以便服务器可以从编辑器的 MCP 整合功能自动启动。

开发

• 代码位于 src/twitter_mcp/ 下，具有清晰的布局：server.py (入口点), app.py (FastMCP app), config.py, api_client.py, 和 tools.py (八个公开工具)。
• 依赖项极小：mcp 框架, httpx 用于 HTTP 调用, 以及 uv 用于环境管理。
• 若要参与项目开发：uv sync 安装, then uv run twitter-mcp。

License – MIT, 所以你可以自由地修改或嵌入到你自己的 AI-assistant 设定的中。

---

底线 – opentwitter-mcp 是一个轻量级、专为用途而生的桥梁，让 AI 编程助手可以查询实时 Twitter 数据并接收事件流，而不需要助手本身实现 Twitter's API。 它 是一项真正的软件项目，旨在于 AI-augmented workflow 相比于仅仅是一个教程或链接列表。