X MCP 服务器

简介

X MCP 服务器是一个用于集成 Twitter 和 Claude 桌面应用的工具。它提供了获取推文、发布新推文和回复推文的功能，并内置了速率限制处理功能。

安装

下载代码

1. 克隆此仓库到本地。
2. 打开终端，进入项目目录。

构建

运行以下命令构建 TypeScript 代码：

npm run build

运行

• 开发模式（带自动监听）：

  npm run dev
  

• 生产模式：

  npm start
  

配置

环境变量

在 claude_desktop_config.json 文件中添加以下配置，替换占位符为你的实际 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"
      }
    }
  }
}

功能

获取主页推文

获取你关注的用户最新发布的推文。

参数：

• 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

开发模式

npm run dev

运行服务器

npm start

速率限制处理

内置了针对 Twitter 免费 tier 的速率限制功能：

• 每月限制：
  • 用户级：每月最多500次发布操作。
  • 应用级：每月最多500次发布操作。
  • 读取操作：每月最多100次。
• 特性：
  • 跟踪每月使用量。
  • 提供指数回退功能以处理速率限制错误。
  • 清晰的错误消息当达到限制时。
  • 自动重试直到速率限制窗口过期。

许可证

MIT

贡献指南

1. 叉仓库。
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。

注意事项

• 请勿泄露你的 API 凭据。
• 建议将敏感信息加密存储。