X(Twitter) V2 MCP Server

这是一个提供与Twitter/X API v2交互工具的MCP服务器实现。此服务允许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（可选）: 地点的“地球上的位置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开发者控制台获得以下所有令牌。

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许可证。这意味着您可以自由地使用、修改和分发该软件，但需遵守MIT许可证的条款和条件。更多详情，请参见项目存储库中的LICENSE文件。