X (Twitter) Scraper

🚀 Twitter MCP 服務器

Twitter MCP 服務器藉助 agent-twitter-client 庫，提供了與 Twitter 進行交互的實用工具，遵循模型上下文協議（MCP），能高效實現推文的檢索與發佈。

🚀 快速開始

此服務器可讓你輕鬆與 Twitter 交互，完成推文檢索和發佈等操作。

✨ 主要特性

• getTweet：可依據推文 ID，精準檢索單條推文。
• sendTweet：支持將新推文發佈至 Twitter。

📦 安裝指南

先決條件

• Node.js（v14 或更高版本）
• npm 或 yarn
• Twitter 賬戶憑證

安裝步驟

1. 克隆此倉庫。
2. 安裝依賴：

npm install
# 或
yarn install

3. 在項目根目錄中創建一個 .env 文件，並添加您的 Twitter 憑證：

TWITTER_USERNAME=your_twitter_username
TWITTER_PASSWORD=your_twitter_password
TWITTER_EMAIL=your_email@example.com (可選)
TWITTER_2FA_SECRET=your_2fa_secret (可選)

# 可選的 API 憑證（作為備用）
TWITTER_API_KEY=your_api_key
TWITTER_API_SECRET_KEY=your_api_secret_key
TWITTER_ACCESS_TOKEN=your_access_token
TWITTER_ACCESS_TOKEN_SECRET=your_access_token_secret

💻 使用示例

基礎用法

運行服務器

您可以使用 FastMCP CLI 工具運行服務器：

# 在開發和測試中在終端使用
npx fastmcp dev

# 使用 MCP 檢查器進行可視化檢查
npx fastmcp inspect

使用工具

getTweet

通過 ID 索單條推文。 參數：

• tweetId (字符串)：要檢索的推文 ID 示例：

getTweet({"tweetId": "1734609533274853865"})

sendTweet

發佈一條新的推文到 Twitter。 參數：

• text (字符串)：要發送的推文內容 示例：

sendTweet({"text": "Hello World from MCP!"})

🔧 技術細節

此服務器使用以下構建：

• FastMCP - 一個用於構建 MCP 服務器的 TypeScript 框架
• agent-twitter-client - 一個 Twitter 客戶端庫

要構建 TypeScript 代碼：

npx tsc

📄 許可證

本項目採用 MIT 許可證。