AI导哈

Twitter API服务协议

这是一个为X（前Twitter）API设计的模型上下文协议（MCP）服务器，支持发布推文、读取时间线、搜索帖子等功能。

  • by HosakaKeigo
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 HosakaKeigo/x-mcp-server

使用说明

X（推特）MCP服务器

这是一个用于X（以前的Twitter）API的模型上下文协议（MCP）服务器。通过Claude Desktop等MCP客户端，您可以发布推文、阅读时间线、搜索帖子等。

特性

此MCP服务器公开了以下工具：

  • post_tweet：发布（发布）带有可选图像或视频附件的推文
  • get_home_timeline：获取经过身份验证的用户的主页时间线
  • 获取用户推特：获取特定用户的最新推文
  • 搜索推特：按关键字搜索推文
  • get_user_info：获取特定用户的信息
  • 喜欢_推特：就像推特
  • 转发：转发推特
工具 描述 关键费率限制（专业/基本/免费）
post_tweet 使用文本和可选图像（最大5MB:PNG、JPEG、GIF、WEBP）或视频（最大512MB:MP4、MOV、AVI、WEBM、M4V）创建新推文 专业版：100个需求/15分钟（每位用户）·10000个需求/24小时（每位应用程序）
基本要求：100个要求/24小时（每位用户）·1667个要求-24小时（每个应用程序）
免费：17个要求/24小时（每个用户/应用程序）
get_home_timeline 从经过身份验证的主页时间线中检索可配置数量的帖子 Pro:180个请求/15分钟（每个用户）
基本：5个要求/15分钟（每位用户）
免费：每15分钟1次（每位用户）
get_user_tweets 检索给定用户名（不带@）的最新推文 优点：900个要求/15分钟（每个用户）·1500个要求/150分钟（每个应用程序）
基本要求：5个要求/15分钟（每位用户）·10个要求.15分钟（每个应用程序）
免费：1个请求/15分钟（每个用户/应用程序）
search_tweets 按关键字搜索最近的推文 专业版：300要求/15分钟（每位用户）·450要求/15 min（每位应用程序）
基本：60个要求/15分钟（每个用户/应用程序）
免费：1个请求/15分钟（每个用户/应用程序）
get_user_info 获取给定用户名的配置文件信息 专业版：900请求/15分钟（每个用户）·300请求/15 min（每个应用程序）
基本：100需求/24小时（每位用户）·500需求/24 h（每位应用程序）
免费：需要3次/15分钟（每个用户/应用程序）
like_tweet 像ID发推文 专业版：1000个需求/24小时（每位用户）
基本：200个需求/24小时（每位用户）
免费：每15分钟1次（每位用户）
retweet 按ID转发推文 专业版：50个请求/15分钟（每位用户）
基本：5个要求/15分钟（每位用户）
免费：每15分钟1次（每位用户）

每月限额：

  • 读取操作 （获取主页时间线、获取用户推特、搜索推特、获取用户信息）：专业版：每月1000000篇·基础版：每月15000篇·免费版：每月100篇
  • 写入操作 （post_tweet、like_weet、retweet）：专业版：每月30万篇·基础版：每月5万篇·免费版：每月500篇

※费率限制参考 docs.com/x-api/基础/费率限制 和 X API定价 （于2025年11月8日检索），并可能随着计划或API行为的发展而变化。

⚠️ 重要通知

X API规范可能会更改。 此服务器实现基于开发时记录的X API v2。请参阅 API官方文件 获取最新的API规范、速率限制和可用端点。

对X API的更改可能会影响：

  • 可用端点及其参数
  • 费率限制和定价级别
  • 身份验证要求
  • 响应格式

设置

1.要求

  • Node.js 18.0.0或更新版本
  • X（Twitter）具有API密钥的开发人员帐户

2.从X开发者门户获取API密钥

  1. 访问 X开发者门户
  2. 创建新应用程序或选择现有应用程序
  3. 收集以下凭据：
    • API密钥（用户密钥）
    • API秘密（消费者秘密）
    • 访问令牌
    • 访问令牌密钥

3.安装依赖项

npm install

4.配置环境变量

复制 .env.example 到 .env 并填写您的密钥：

cp .env.example .env

编辑 .env:

X_API_KEY=your_api_key_here
X_API_SECRET=your_api_secret_here
X_ACCESS_TOKEN=your_access_token_here
X_ACCESS_TOKEN_SECRET=your_access_token_secret_here

5.建造

npm run build

与Claude Desktop一起使用

快速安装（DXT/mcpb）

预构建包可从 发布 页面。您可以下载 .mcpb 文件并直接安装在Claude Desktop中。

  1. 下载最新 .mcpb 文件来自 发布
  2. 在Claude Desktop中，转到 设置→ 扩展
  3. 通过以下方法之一安装扩展：
    • 双击下载的 .mcpb 文件，或
    • 将文件拖放到Claude Desktop中，或
    • 在扩展设置中单击“从文件安装”
  4. 在扩展设置中配置您的X API凭据：
    • X_API_KEY：您的API密钥（消费者密钥）
    • X_API_SECRET：您的API秘密（消费者秘密）
    • X_ACCESS_TOKEN：您的访问令牌
    • X_ACCESS_TOKEN_SECRET：您的访问令牌密钥

如果遇到错误：

  • 验证您的API键是否正确（没有额外的空格或引号）
  • 完全重新启动克劳德桌面
  • 查看日志：
    • macOS： ~/Library/Logs/Claude/mcp*.log
    • 窗户： %APPDATA%\Claude\logs\mcp*.log

手动设置

1.打开Claude Desktop配置文件

您可以通过Claude Desktop设置或直接访问配置文件：

通过克劳德桌面：

  • 首选 设置→ 开发者→ 编辑配置

直接文件路径：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

2.添加MCP服务器条目

添加以下配置（根据需要调整路径）：

macOS/Linux：

{
  "mcpServers": {
    "x-twitter": {
      "command": "node",
      "args": ["/Users/username/path/to/x-mcp-server/dist/index.js"],
      "env": {
        "X_API_KEY": "your_api_key",
        "X_API_SECRET": "your_api_secret",
        "X_ACCESS_TOKEN": "your_access_token",
        "X_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

窗户：

{
  "mcpServers": {
    "x-twitter": {
      "command": "node",
      "args": ["C:\\Users\\username\\path\\to\\x-mcp-server\\dist\\index.js"],
      "env": {
        "X_API_KEY": "your_api_key",
        "X_API_SECRET": "your_api_secret",
        "X_ACCESS_TOKEN": "your_access_token",
        "X_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

3.重新启动克劳德桌面

完全重新启动Claude Desktop，以便设置生效。

macOS：

  • 从菜单中选择“退出克劳德”
  • 再次启动克劳德桌面

窗户：

  • 从任务管理器终止Claude Desktop
  • 再次启动克劳德桌面

4.验证连接

重新启动后，确认工具图标(🔨) 显示在Claude输入框的左下角。

使用示例

向Claude Desktop询问以下问题：

"Fetch the latest 10 posts from my home timeline."

"Search for the latest 5 tweets about 'AI technology'."

"Get the latest tweets from @example_user."

"Show me the profile for @example_user."

"Post the tweet 'Hello, this is an MCP server test!'"

"Post a tweet with the text 'Check out this image!' and attach the image at /path/to/image.png"

"Post a tweet with the text 'My new video!' and attach the video at /path/to/video.mp4"

故障排除

DXT/mcpb安装错误

如果在使用DXT/mcpb软件包时遇到错误：

  1. 验证API密钥是否正确

    • 双重勾选所有四个凭证（API密钥、API机密、访问令牌、访问令牌机密）
    • 确保配置中没有多余的空格或引号
    • 验证密钥在 X开发者门户

  2. 重新启动克劳德桌面

    • 完全退出并重新启动Claude Desktop
    • macOS： 从菜单中选择“退出克劳德”
    • 窗户： 从任务管理器终止Claude Desktop

  3. 检查日志以了解详细错误

    • macOS： ~/Library/Logs/Claude/mcp*.log
    • 窗户： %APPDATA%\Claude\logs\mcp*.log

Claude Desktop未检测到服务器

  1. 完全重新启动Claude Desktop
  2. 仔细检查中的语法错误 claude_desktop_config.json
  3. 确保路径 dist/index.js 正确（使用绝对路径）
  4. 检查日志：
    • macOS： ~/Library/Logs/Claude/mcp*.log
    • 窗户： %APPDATA%\Claude\logs\mcp*.log

发生API错误

  1. 确认环境变量设置正确
  2. 验证您的X应用程序是否具有所需的权限（读取和写入）
  3. 确保API密钥仍然有效

手动测试服务器

# Run in development mode
npm run dev

# Or run the built output
npm run build
node dist/index.js

发展

观看模式

npm run watch

在另一个终端中：

npm run dev

许可证

麻省理工学院

相关 MCP