X(Twitter) V2 MCP Server

X(Twitter) V2 MCP Server

site icon
2025.04.17 0
TypeScript社交媒体管理Twitter/X API 交互交流协作
x-v2-server 是一个 MCP 服务器实现,专门用于与 Twitter/X API v2 进行交互。该服务允许 AI 助手以编程方式获取推文、发布新内容、回复推文、引用推文等。
View on GitHub

Overview

基本能力

产品定位

x-v2-server 是一个专门用于与 Twitter/X API v2 交互的 MCP 服务器,旨在为 AI 助手提供丰富的 Twitter/X 功能支持。

核心功能

  • 获取用户时间线的推文
  • 通过 ID 获取单条推文
  • 获取提及特定用户的推文
  • 引用推文并添加自定义文本
  • 回复推文
  • 发布新推文
  • 点赞推文
  • 关注/取消关注用户
  • 通过用户名获取用户信息
  • 搜索推文
  • 获取热门话题
  • 创建和管理 Twitter 列表

适用场景

  • AI 助手需要与 Twitter/X 平台进行交互
  • 自动化社交媒体管理
  • 数据分析和内容监控

工具列表

  1. get_tweets_by_userid: 获取特定用户时间线的推文
  2. get_tweet_by_id: 通过 ID 获取单条推文
  3. get_user_mentions: 获取提及特定用户的推文
  4. quote_tweet: 引用推文并添加自定义文本
  5. reply_to_tweet: 回复推文
  6. post_tweet: 发布新推文
  7. like_tweet: 点赞推文
  8. follow_user: 关注用户
  9. unfollow_user: 取消关注用户
  10. get_user_by_username: 通过用户名获取用户信息
  11. search_tweets: 搜索推文
  12. get_trending_topics: 获取热门话题
  13. create_list: 创建 Twitter 列表
  14. add_list_member: 添加用户到列表
  15. remove_list_member: 从列表中移除用户
  16. get_owned_lists: 获取用户拥有的所有列表

常见问题解答

  • 如何获取 Twitter/X API 认证信息? 可以通过 X Developer Dashboard 获取所有需要的令牌。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 从 X Developer Dashboard 获取以下认证信息:
  3. TWITTER_API_KEY
  4. TWITTER_API_KEY_SECRET
  5. TWITTER_ACCESS_TOKEN
  6. TWITTER_ACCESS_TOKEN_SECRET

安装教程

npm i
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

调试方式

  1. 安装完成后,打开 http://127.0.0.1:6274
  2. 设置环境变量
  3. 与工具进行交互

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。