x-mcp
使用OAuth 2.0应用程序专用(承载令牌)身份验证的只读X/Twitter MCP服务器。
特性
- 只读 -没有写操作,只有数据检索
- 承载令牌身份验证 -仅使用应用程序身份验证,不需要用户OAuth流
- 15工具 涵盖:
- 用户查找(按用户名、ID或经过身份验证的用户) - 推特查询(按ID) - 用户时间线和提及 - 最近搜索(过去7天) - 关注者/关注列表 - 喜欢和转发
设置
- 从获取X API承载令牌 developer.x.com
- 在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许可证
麻省理工学院
