X(Twitter) V2 MCP Server

X(Twitter) V2 MCP 服务

一个 MCP 服务实现，提供用于与 Twitter/X API v2 交互的工具。此服务允许 AI 助手以编程方式检索推文、发布新内容、回复推文、引用推文等。

工具

X MCP 服务提供以下工具，用于与 Twitter/X API 交互：

get_tweets_by_userid

检索特定用户时间线中的推文。

• userId：用于搜索推文的 Twitter 用户 ID
• paginationToken（可选）：用于获取下一页结果的令牌
• exclude（可选）：要排除的推文类型（转推、回复）
• maxResults（可选）：返回的推文数量上限（默认值：10）

get_tweet_by_id

根据推文 ID 检索单条推文。

• tweetId：要检索的推文 ID

get_user_mentions

检索提及特定用户的推文。

• userId：要获取提及内容的 Twitter 用户 ID
• paginationToken（可选）：用于获取下一页结果的令牌
• maxResults（可选）：返回的提及内容数量上限（默认值：10）

quote_tweet

使用自定义文本创建引用推文。

• tweetId：要引用的推文 ID
• replyText：要随引用内容一起发布的文本

reply_to_tweet

回复现有推文。

• tweetId：要回复的推文 ID
• replyText：回复内容

post_tweet

发布新推文。

• text：要发布的内容。
• imageBase64：要发布的图片。

like_tweet

点赞指定推文。

• tweetId：要点赞的推文 ID

follow_user

关注 Twitter 用户。

• targetUserId：要关注的用户 ID

unfollow_user

取消关注 Twitter 用户。

• targetUserId：要取消关注的用户 ID

get_user_by_username

根据用户名获取 Twitter 用户信息。

• username：Twitter 用户名（不含 @ 符号）

search_tweets

使用查询字符串搜索推文。

• query：搜索查询
• maxResults（可选）：返回的结果数量上限（默认值：10）

get_trending_topics

获取特定位置的热门话题。

• woeid（可选）：该位置的“Where On Earth ID”（WOEID）（全球范围为 1，默认值：1）

create_list

创建新的 Twitter 列表。

• name：列表名称
• description（可选）：列表的可选描述
• isPrivate（可选）：列表是否设为私密（默认值：false）

add_list_member

将用户添加到 Twitter 列表。

• listId：列表 ID
• userId：要添加的用户 ID

remove_list_member

从 Twitter 列表中移除用户。

• listId：列表 ID
• userId：要移除的用户 ID

get_owned_lists

获取经身份验证的用户拥有的所有列表。

• 无需参数

配置

环境配置

X API 身份验证

你可以通过 X Developer Dashboard 获取以下所有令牌

TWITTER_API_KEY=your_api_key
TWITTER_API_KEY_SECRET=your_api_secret
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

开发

npm i

npm run build

npx @modelcontextprotocol/inspector node dist/index.js

打开 http://127.0.0.1:6274 设置环境变量，并与这些工具交互。

许可证

此 MCP 服务根据 MIT License 获得许可。这意味着你可以自由使用、修改和分发该软件，但须遵守 MIT License 的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。