Twitter API服务

X-MCP 2.0是一个基于OAuth 2.0 PKCE认证的Twitter API v2服务器,支持发推、搜索、点赞、转发等多种功能,并自动刷新令牌。

  • by JialiangFan
  • TypeScript
  • 本地部署
  • 7 星标
  • 更新于
在 GitHub 查看 JFan5/X-MCP-2.0

使用说明

X-MCP 2.0

MCP服务器 X/Twitter API v2 和 OAuth 2.0 PKCE 身份验证。

使用现代OAuth 2.0,使用Claude发布推文、搜索X、点赞、转发等。

为什么是2.0?

原版 twitter mcp 使用OAuth 1.0a,它需要4个单独的密钥,并且不支持较新的API功能。X-MCP 2.0使用 OAuth 2.0与PKCE,Twitter API v2的推荐身份验证方法。

功能 推特mcp X-mcp 2.0
Auth OAuth 1.0a(4个密钥) OAuth 2.0 PKCE(现代)
令牌刷新 否 自动刷新
发布推特 是 是
搜索 是 是
获取推特 否 是
用户资料 否 是
主页时间线 否 是
喜欢 否 是
转发 否 是
回复 否 是
用户推文 否 是
MCP软件开发工具包 0.6.0 1.x

工具(10)

工具 说明
post_tweet 发布推文(支持回复和引用推文)
search_tweets 按查询搜索推文
get_tweet 按ID获取特定推文
get_my_profile 获取您的个人资料信息
get_user 按用户名获取任何用户的个人资料
get_timeline 获取您的家庭时间表
like_tweet 像推特一样
retweet 转发推特
reply_to_tweet 回复推特
get_user_tweets 获取用户最近的推文

设置

1.获取Twitter API凭据

  1. 首选 developer.x.com 并创建一个应用程序
  2. 在...之下 密钥和令牌,查找 OAuth 2.0客户端ID和客户端密钥
  3. 在...之下 用户认证设置,单击 设置:
    • 应用程序权限: 读写
    • 应用程序类型: Web应用程序、自动应用程序或机器人
    • 回调URI: http://127.0.0.1:8739/callback
    • 网站URL:您的网站或GitHub个人资料

2.授权(一次)

git clone https://github.com/JFan5/X-MCP-2.0.git
cd X-MCP-2.0
npm install

# Run the auth flow — opens browser for Twitter login
CLIENT_ID=your_client_id CLIENT_SECRET=your_client_secret npm run auth

这将令牌保存到 ~/.x-mcp-tokens.json 并打印 ACCESS_TOKEN 和 REFRESH_TOKEN.

3.配置Claude

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "x-mcp": {
      "command": "node",
      "args": ["/path/to/X-MCP-2.0/dist/index.js"],
      "env": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret",
        "ACCESS_TOKEN": "your_access_token",
        "REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

或为 克劳德代码,添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "x-mcp": {
      "command": "node",
      "args": ["/path/to/X-MCP-2.0/dist/index.js"],
      "env": {
        "CLIENT_ID": "your_client_id",
        "CLIENT_SECRET": "your_client_secret",
        "ACCESS_TOKEN": "your_access_token",
        "REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

4.构建(如果从源代码运行)

npm run build

令牌刷新

如果你包括 REFRESH_TOKEN,X-MCP 2.0会在访问令牌过期时(每2小时一次)自动刷新您的访问令牌。无需人工干预。

例子

问克劳德:

  • “发布一条关于我的新开源项目的推文”
  • “搜索关于GRPO强化学习的推文”
  • “我的推特时间线上有什么?”
  • “就像关于机器学习的热门推文”
  • “显示@kaboroevich最近的推文”

许可证

麻省理工学院