AI导哈

只读X/Twitter数据服务

一个使用OAuth 2.0 App-Only (Bearer Token)认证的只读X/Twitter MCP服务器，提供用户查找、推文查找、用户时间线、最近搜索、关注者/关注列表、喜欢和转推等功能。

  • by windsornguyen
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 windsornguyen/x-api-mcp

使用说明

x-mcp

使用OAuth 2.0应用程序专用（承载令牌）身份验证的只读X/Twitter MCP服务器。

特性

  • 只读 -没有写操作，只有数据检索
  • 承载令牌身份验证 -仅使用应用程序身份验证，不需要用户OAuth流
  • 15工具 涵盖：
    • 用户查找（按用户名、ID或经过身份验证的用户）
    • 推特查询（按ID）
    • 用户时间线和提及
    • 最近搜索（过去7天）
    • 关注者/关注列表
    • 喜欢和转发

设置

  1. 从获取X API承载令牌 developer.x.com
  2. 在Dedalus MCP客户端中配置令牌

身份验证说明

此服务器使用 仅限OAuth 2.0应用程序（承载令牌） 身份验证，其中：

  • ✅ 适用于公共用户/推特查找、搜索、关注者、点赞、转发
  • ❌ 不适用于 /users/me （需要通过OAuth 2.0 PKCE提供用户上下文）

如果您需要用户上下文（例如，访问私人数据或经过身份验证的用户的个人资料）， 您需要使用PKCE来实现OAuth 2.0授权代码流。

可用工具

用户

  • x_whoami -获取经过身份验证的用户配置文件
  • x_get_user_by_username -按用户名获取用户
  • x_get_user -按ID获取用户
  • x_get_users -按ID获取多个用户

推文

  • x_get_tweet -通过ID获取推文
  • x_get_tweets -按ID获取多条推文
  • x_get_user_tweets -获取用户最近的推文
  • x_get_user_mentions -获取提及用户的推文

搜索

  • x_search_recent -搜索最近的推文（过去7天）

社交图谱

  • x_get_followers -获取用户的关注者
  • x_get_following -让用户关注用户

参与

  • x_get_user_liked_tweets -获取用户喜欢的推文
  • x_get_liking_users -获取喜欢推特的用户
  • x_get_retweeted_by -获取转发推特的用户

搜索查询示例

这 x_search_recent 该工具支持X的搜索运算符：

from:elonmusk              # Tweets from a user
#AI                        # Tweets with hashtag
machine learning -is:retweet   # Exclude retweets
python lang:en             # English tweets only
"exact phrase"             # Exact phrase match

看 X API搜索文档 更多的运营商。

跑步

cd x-mcp
uv run python src/main.py

许可证

麻省理工学院

相关 MCP