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: 您要发布的内容。

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 (可选): 该位置的“地球上哪里 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 获取以下所有令牌

X_API_KEY=your_api_key
X_API_SECRET=your_api_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_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 许可证下获得许可。 这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。 有关更多详细信息，请参阅项目存储库中的 LICENSE 文件。