X MCP 服务器

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

<a href="https://glama.ai/mcp/servers/5nx3qqiunw"><img width="380" height="200" src="https://glama.ai/mcp/servers/5nx3qqiunw/badge" alt="X Server MCP server" /></a>

功能

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

前提条件

• Node.js (v16 或更高版本)
• X (Twitter) 开发者帐户（免费）
• Claude 桌面应用程序

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 [您的仓库 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 集成”）
   • 选择“免费”作为您的设置
   • 选择您的用例
   • 点击“下一步”

4. 在您的项目中创建一个新应用：

   • 点击“创建应用”
   • 输入应用名称
   • 点击“完成设置”

5. 配置应用设置：

   • 在您的应用仪表板中，点击“应用设置”
   • 在“用户身份验证设置”下：
     • 点击“设置”
     • 启用 OAuth 1.0a
     • 选择“Web 应用”或“原生应用”
     • 输入任何回调 URL（例如，https://example.com/callback）
     • 输入任何网站 URL（例如，https://example.com）
     • 点击“保存”

6. 设置应用权限：

   • 在应用设置中，找到“应用权限”
   • 更改为“读取和写入”
   • 点击“保存”

7. 生成 API 密钥和令牌：

   • 转到“密钥和令牌”选项卡
   • 在“Consumer Keys”下：
     • 点击“查看密钥”或“重新生成”
     • 保存您的 API 密钥和 API 密钥 Secret
   • 在“Access Token and Secret”下：
     • 点击“生成”
     • 确保选择具有“读取和写入”权限的令牌
     • 保存您的 Access Token 和 Access Token Secret

重要提示：

• 确保您的密钥和令牌安全，切勿公开分享
• 您需要所有四个值：
  • API 密钥（也称为 Consumer Key）
  • API 密钥 Secret（也称为 Consumer Secret）
  • Access Token
  • Access Token Secret
• 记住免费层级的限制：
  • 每个用户每月 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 扩展名保存文件

可用工具

get_home_timeline

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

参数：

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

示例：

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

create_tweet

创建一个新的推文。

参数：

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

示例：

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

reply_to_tweet

回复一条推文。

参数：

• 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 次读取
• 功能：
  • 跟踪每月使用情况
  • 为速率限制错误提供指数退避
  • 达到限制时显示清晰的错误消息
  • 速率限制窗口过期后自动重试

许可证

MIT

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 将分支推送到远程仓库 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request