X MCP 服务器

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

特征

• 从你的主页时间线获取推文

• 创建新推文

• 回复推文

• 免费 API 层的内置速率限制处理

• 具有完全类型安全性的 TypeScript 实现

Related MCP server: X (Twitter) MCP Server - Enhanced Edition

先决条件

• 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. 克隆存储库：

git clone [your-repo-url]
cd x-mcp-server

2. 安装依赖项：

npm install

3. 构建服务器：

npm run build

配置

您需要设置您的 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 凭据：

{
  "mcpServers": {
    "x": {
      "command": "node",
      "args": ["%USERPROFILE%/Projects/MCP Basket/x-server/build/index.js"],
      "env": {
        "TWITTER_API_KEY": "paste-your-api-key-here",
        "TWITTER_API_SECRET": "paste-your-api-key-secret-here",
        "TWITTER_ACCESS_TOKEN": "paste-your-access-token-here",
        "TWITTER_ACCESS_SECRET": "paste-your-access-token-secret-here"
      }
    }
  }
}

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

注意：请确保：

• 将所有四个凭证值替换为您的实际 API 密钥和令牌

• 在每个值两边添加引号 ("")

• 保持上面显示的精确间距和格式

• 使用.json扩展名保存文件

可用工具

获取主页时间线

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

参数：

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

例子：

await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 }
});

创建推文

创建新推文。

参数：

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

例子：

await use_mcp_tool({
  server_name: "x",
  tool_name: "create_tweet",
  arguments: { text: "Hello from MCP! 🤖" }
});

回复推文

回复推文。

参数：

• tweet_id （必填）：要回复的推文的 ID

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

例子：

await use_mcp_tool({
  server_name: "x",
  tool_name: "reply_to_tweet",
  arguments: {
    tweet_id: "1234567890",
    text: "Great tweet! 👍"
  }
});

发展

• 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. 打开拉取请求