X.com MCP Server

🚀 X.com MCP服務器

這是一個模型上下文協議（MCP）服務器，可提供對X.com API功能的訪問。該服務器允許大語言模型（LLMs）通過OAuth 2.0認證與X.com（原Twitter）進行交互，支持所有主要的帖子相關操作，包括讀取、撰寫、搜索和管理帖子、點贊、轉發和收藏等。

🚀 快速開始

X.com MCP服務器提供了便捷的方式讓LLMs與X.com進行交互。你可以按照以下步驟快速開始使用：

1. 完成安裝（具體安裝方式見“📦 安裝指南”）。
2. 進行配置，包括設置環境變量和完成認證（具體配置方法見“📚 詳細文檔”）。
3. 參考“💻 使用示例”中的示例交互，發起請求與X.com進行交互。

✨ 主要特性

• OAuth 2.0認證 - 安全的Bearer令牌認證方式。
• 完整的帖子API覆蓋 - 涵蓋X.com官方API中所有帖子相關的端點。
• 類型安全 - 完全使用TypeScript實現，並結合Zod進行驗證。
• 全面的工具集 - 提供21個工具，涵蓋X.com的所有主要操作。

📦 安裝指南

使用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

💻 使用示例

基礎用法

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"
  }
}

📚 詳細文檔

可用工具

查找

• getSinglePost - 根據ID檢索單個帖子，可選擇擴展字段。
• getBulkPosts - 根據ID批量檢索最多100個帖子。

管理帖子

• createPost - 創建包含文本、媒體、投票、回覆等內容的新帖子。
• deletePost - 根據ID刪除帖子。
• hideReply - 隱藏或顯示帖子的回覆。

時間線

• getUserTimeline - 獲取用戶的帖子時間線。
• getUserMentions - 獲取提及特定用戶的帖子。

搜索

• searchRecent - 搜索近期帖子（過去7天）。
• searchAll - 搜索所有帖子（完整存檔 - 需要學術/企業訪問權限）。

帖子數量統計

• getPostCountsRecent - 獲取近期帖子按時間桶劃分的數量統計。
• getPostCountsAll - 獲取所有帖子按時間桶劃分的數量統計（學術/企業）。

轉發

• getRetweets - 獲取轉發特定帖子的帖子。
• createRetweet - 轉發帖子。
• deleteRetweet - 取消轉發。

點贊

• getLikingUsers - 獲取點贊特定帖子的用戶。
• getLikedTweets - 獲取用戶點讚的帖子。
• likePost - 點贊帖子。
• unlikePost - 取消點贊帖子。

收藏

• getUserBookmarks - 獲取用戶收藏的帖子。
• bookmarkPost - 收藏帖子。
• removeBookmark - 取消收藏。

配置

環境變量

• X_COM_ACCESS_TOKEN（必需）：你的X.com OAuth 2.0訪問令牌。

認證設置

1. 在 developer.x.com 創建X.com開發者賬戶。
2. 創建新的項目和應用。
3. 生成OAuth 2.0憑證。
4. 實現OAuth 2.0授權碼與PKCE流程。
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"]
  }
}

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. “獲取我近期的收藏並分析主題。”

構建

# 安裝依賴
pnpm install

# 構建TypeScript
pnpm run build

# 啟動服務器
pnpm start

速率限制

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

• 大多數讀取操作：每15分鐘300個請求。
• 寫入操作：每15分鐘50個請求。
• 收藏操作：每15分鐘50次寫入 / 180次讀取。

詳細的速率限制信息請參考 X.com API文檔。