X.com MCP Server

X.com MCP 服务

一个可访问 X.com API 功能的模型上下文协议服务。此服务通过 OAuth 2.0 身份验证，让大模型能够与 X.com（原 Twitter）交互，支持所有主要的帖子相关操作，包括读取、发布、搜索和管理帖子、点赞、转发和书签。

功能

• OAuth 2.0 身份验证 - 安全的 Bearer 令牌身份验证
• 完整的帖子 API 覆盖范围 - 涵盖官方 API 中所有 X.com 帖子端点
• 类型安全 - 使用 Zod 验证的完整 TypeScript 实现
• 全面的工具 - 21 个工具，覆盖所有主要的 X.com 操作

可用工具

查询

• getSinglePost - 按 ID 获取单条帖子，可选择展开字段
• getBulkPosts - 按 ID 获取最多 100 条帖子

管理帖子

• createPost - 创建新帖子，支持文本、媒体、投票、回复等
• deletePost - 按 ID 删除帖子
• hideReply - 隐藏或取消隐藏对帖子的回复

时间线

• getUserTimeline - 获取用户的帖子时间线
• getUserMentions - 获取提及特定用户的帖子

搜索

• searchRecent - 搜索近期帖子（最近 7 天）
• searchAll - 搜索所有帖子（完整归档，需要 Academic/Enterprise 访问权限）

帖子计数

• getPostCountsRecent - 获取近期帖子的分时段计数
• getPostCountsAll - 获取所有帖子的分时段计数（Academic/Enterprise）

转发

• getRetweets - 获取转发特定帖子的帖子
• createRetweet - 转发帖子
• deleteRetweet - 移除转发

点赞

• getLikingUsers - 获取为特定帖子点赞的用户
• getLikedTweets - 获取用户点赞过的帖子
• likePost - 为帖子点赞
• unlikePost - 取消对帖子的点赞

书签

• getUserBookmarks - 获取用户收藏的帖子
• bookmarkPost - 收藏帖子
• removeBookmark - 移除书签

安装

使用 pnpm（推荐）

pnpm install
pnpm run build

安装后，可通过以下命令运行：

node dist/index.js

使用 Docker

docker build -t x.com-mcp .
docker run -i --rm -e X_COM_ACCESS_TOKEN=your-access-token x.com-mcp

配置

环境变量

• X_COM_ACCESS_TOKEN（必需）：你的 X.com OAuth 2.0 访问令牌

身份验证设置

1. 在 developer.x.com 创建 X.com 开发者账户
2. 创建新项目和应用
3. 生成 OAuth 2.0 凭据
4. 实现带 PKCE 的 OAuth 2.0 授权码流程
5. 将生成的访问令牌保存为 X_COM_ACCESS_TOKEN

为 Claude.app 配置

将以下内容添加到 Claude 设置中：

"mcpServers": {
  "x-com": {
    "command": "node",
    "args": ["dist/index.js"],
    "env": {
      "X_COM_ACCESS_TOKEN": "your-access-token"
    }
  }
}

"mcpServers": {
  "x-com": {
    "command": "docker",
    "args": ["run", "-i", "--rm", "-e", "X_COM_ACCESS_TOKEN=your-access-token", "x.com-mcp"]
  }
}

交互示例

1. 创建帖子：

{
  "name": "createPost",
  "arguments": {
    "text": "Hello world! This is my first post via the MCP server.",
    "reply_settings": "everyone"
  }
}

2. 搜索近期帖子：

{
  "name": "searchRecent",
  "arguments": {
    "query": "artificial intelligence",
    "max_results": 10,
    "tweet.fields": "created_at,author_id,public_metrics"
  }
}

3. 获取用户时间线：

{
  "name": "getUserTimeline",
  "arguments": {
    "id": "123456789",
    "max_results": 20,
    "expansions": "author_id"
  }
}

4. 为帖子点赞：

{
  "name": "likePost",
  "arguments": {
    "user_id": "123456789",
    "tweet_id": "987654321"
  }
}

5. 获取帖子计数：

{
  "name": "getPostCountsRecent",
  "arguments": {
    "query": "machine learning",
    "granularity": "day"
  }
}

覆盖的 API 端点

此服务实现了 X.com API v2 规范中所有与帖子相关的端点：

• 查询：/2/tweets/:id、/2/tweets
• 管理帖子：/2/tweets (POST)、/2/tweets/:id (DELETE)、/2/tweets/:id/hidden (PUT)
• 时间线：/2/users/:id/tweets、/2/users/:id/mentions
• 搜索：/2/tweets/search/recent、/2/tweets/search/all
• 帖子计数：/2/tweets/counts/recent、/2/tweets/counts/all
• 转发：/2/tweets/:id/retweets、/2/users/:id/retweets
• 点赞：/2/tweets/:id/liking_users、/2/users/:id/liked_tweets、/2/users/:id/likes
• 书签：/2/users/:id/bookmarks

必需权限范围

确保你的 X.com 应用具有以下 OAuth 2.0 权限范围：

• tweet.read - 读取帖子和用户信息
• tweet.write - 创建和删除帖子
• tweet.moderate.write - 隐藏或取消隐藏回复
• users.read - 读取用户信息
• like.read - 读取点赞信息
• like.write - 点赞和取消点赞
• bookmark.read - 读取书签
• bookmark.write - 创建和删除书签

调试

你可以使用 MCP 检查器调试此服务：

npx @modelcontextprotocol/inspector node dist/index.js

Claude 问题示例

1. “你能搜索近期关于人工智能的帖子吗？”
2. “发布一篇关于 TypeScript 优势的帖子。”
3. “查找提及机器学习的帖子，并显示其互动指标。”
4. “获取我最近收藏的书签，并分析相关主题。”

构建

# Install dependencies
pnpm install

# Build TypeScript
pnpm run build

# Start server
pnpm start

速率限制

请注意 X.com API 的速率限制：

• 大多数读取操作：每 15 分钟 300 次请求
• 写入操作：每 15 分钟 50 次请求
• 书签操作：每 15 分钟 50 次写入 / 180 次读取

详细的速率限制信息，请参阅 X.com API 文档。