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 许可证。