X MCP 服务器

一个用于 X (Twitter) 集成的模型上下文协议 (MCP) 服务器，提供读取时间线和与推文互动的工具。专为配合 Claude 桌面使用而设计。

特征

• 从你的主页时间线获取推文
• 创建新推文
• 回复推文
• 免费 API 层的内置速率限制处理
• 具有完全类型安全性的 TypeScript 实现

先决条件

• Node.js（v16 或更高版本）
• X（Twitter）开发者账户（免费）
• 克劳德桌面应用程序

X API 访问

X（Twitter）提供了基本 API 访问的免费层：

免费套餐功能

• 发帖限制：
  • 用户级别每月 500 个帖子
  • 应用程序级别每月发布 500 篇帖子
• 读取限制：
  • 每月阅读量 100 次
• 特征：
  • 访问 v2 帖子发布端点
  • 媒体上传端点
  • 访问广告 API
  • 仅限 1 个应用 ID
  • 使用 X 功能登录
• 速率限制：
  • 对所有端点的访问速率受限
  • 限制定期重置

注意：对于更高容量的需求，可以选择付费套餐：

• 基本套餐（100 美元/月）：每月 50,000 条推文，附加端点
• 专业级（每月 5000 美元）：更高的限额和企业功能

您可以通过以下网址访问免费套餐： https://developer.x.com/en/portal/products/free

安装

1. 克隆存储库：

2. 安装依赖项：

3. 构建服务器：

配置

您需要设置您的 X (Twitter) API 凭证。请遵循以下步骤：

1. 前往Twitter 开发者门户
   • 使用您的 X（Twitter）帐户登录
   • 如果您没有开发者帐户，系统会提示您创建一个
2. 访问免费套餐：
   • 访问https://developer.x.com/en/portal/products/free
   • 点击“订阅”即可获得免费访问层级
   • 完成注册流程
3. 创建新项目：
   • 点击“创建项目”按钮
   • 输入项目名称（例如“MCP Integration”）
   • 选择“免费”作为设置
   • 选择您的用例
   • 点击“下一步”
4. 在您的项目中创建一个新的应用程序：
   • 点击“创建应用程序”
   • 输入应用名称
   • 点击“完成设置”
5. 配置应用程序设置：
   • 在您的应用程序信息中心中，点击“应用程序设置”
   • 在“用户身份验证设置”下：
     • 点击“设置”
     • 启用 OAuth 1.0a
     • 选择“Web 应用”或“原生应用”
     • 输入任意回调 URL（例如https://example.com/callback ）
     • 输入任意网站 URL（例如https://example.com ）
     • 点击“保存”
6. 设置应用权限：
   • 在应用设置中，找到“应用权限”
   • 更改为“读写”
   • 点击“保存”
7. 生成 API 密钥和令牌：
   • 转到“密钥和令牌”选项卡
   • 在“消费者密钥”下：
     • 点击“查看密钥”或“重新生成”
     • 保存您的 API 密钥和 API 密钥秘密
   • 在“访问令牌和秘密”下：
     • 点击“生成”
     • 确保选择具有“读写”权限的令牌
     • 保存您的访问令牌和访问令牌密钥

重要的：

• 确保你的密钥和令牌安全，切勿公开分享
• 您将需要所有四个值：
  • API 密钥（也称为消费者密钥）
  • API 密钥秘密（也称为消费者密钥）
  • 访问令牌
  • 访问令牌秘密
• 记住免费套餐限制：
  • 用户级别每月 500 个帖子
  • 应用程序级别每月发布 500 篇帖子
  • 每月阅读量 100 次

Claude桌面配置

要将 X MCP 服务器与 Claude 桌面连接，您需要在 Claude 设置中进行配置。请按照以下步骤操作：

1. 打开文件资源管理器
2. 导航到 Claude 配置目录：
   • 按 Win + R
   • 输入%APPDATA%/Claude并按 Enter
   • 如果 Claude 文件夹不存在，请创建它
3. 创建或编辑claude_desktop_config.json ：
   • 如果该文件不存在，则创建一个名为claude_desktop_config.json的新文件
   • 如果存在，请在文本编辑器（如记事本）中打开它
4. 添加以下配置，将占位符值替换为上一节中的实际 API 凭据：

5. 保存文件并重新启动Claude桌面

注意：请确保：

• 将所有四个凭证值替换为您的实际 API 密钥和令牌
• 在每个值两边添加引号 ("")
• 保持上面显示的精确间距和格式
• 使用.json扩展名保存文件

可用工具

获取主页时间线

从您的主页时间线获取最新的推文。

参数：

• limit （可选）：要检索的推文数量（默认值：20，最大值：100）

例子：

创建推文

创建新推文。

参数：

• text （必填）：推文的文本内容（最多 280 个字符）

例子：

回复推文

回复推文。

参数：

• tweet_id （必填）：要回复的推文的 ID
• text （必填）：回复的文本内容（最多280个字符）

例子：

发展

• npm run build ：构建 TypeScript 代码
• npm run dev ：在监视模式下运行 TypeScript
• npm start ：启动 MCP 服务器

速率限制

该服务器包括针对 X 免费层的内置速率限制处理：

• 每月限额：
  • 用户级别每月 500 个帖子
  • 应用程序级别每月发布 500 篇帖子
  • 每月阅读量 100 次
• 特征：
  • 跟踪每月使用情况
  • 为速率限制错误提供指数退避
  • 达到限制时清除错误消息
  • 速率限制窗口到期后自动重试

执照

麻省理工学院

贡献

1. 分叉存储库
2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）
3. 提交您的更改（ git commit -m 'Add some amazing feature' ）
4. 推送到分支（ git push origin feature/amazing-feature ）
5. 打开拉取请求