X（Twitter）V2 MCP 服务器

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

工具

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

get_tweets_by_userid

从特定用户的个人资料中检索推文。

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

get_tweet_by_id

通过 ID 获取单条推文。

• tweetId: 要获取的推文 ID

get_user_mentions

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

• userId: 要获取提及信息的用户 ID
• paginationToken（可选）: 获取下一页结果的令牌
• maxResults（可选）: 返回的最大提及数量（默认：10）

quote_tweet

创建带有自定义文本的引用推文。

• tweetId: 要引用的推文 ID
• replyText: 引用中包含的文本

reply_to_tweet

回复现有的推文。

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

post_tweet

发布新推文。

• text: 推文内容
• imageBase64: 要发布的图片（Base64 格式）

like_tweet

点赞特定推文。

• tweetId: 要点赞的推文 ID

follow_user

关注 Twitter 用户。

• targetUserId: 要关注的用户 ID

unfollow_user

取消关注 Twitter 用户。

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

get_user_by_username

通过用户名获取 Twitter 用户信息。

• username: 用户名（不带 @ 符号）

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

获取当前登录用户的所有列表。

• 无参数

配置

要使用此 MCP 服务器，需要设置以下环境变量：

# 示例配置

开发

1. 克隆仓库：

git clone https://github.com/yourusername/x-v2-server.git
cd x-v2-server

2. 安装依赖项：

npm install

3. 启动服务器：

node index.js

文档

• API 文档
• 开发者指南

许可证

[插入许可证信息]

此文档为 X（Twitter）V2 MCP 服务器的使用和开发提供了全面说明。