X MCP Server

基本能力

产品定位

X MCP Server 是一个专为 X（Twitter）集成设计的 MCP 服务器，主要用于读取用户时间线和与推文互动。

核心功能

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

适用场景

• 个人用户希望通过自动化工具管理 Twitter 账户
• 开发者需要集成 Twitter 功能到自己的应用中
• 需要与 Claude 桌面应用集成的场景

工具列表

1. get_home_timeline: 获取用户时间线上的最新推文
2. 参数: limit（可选，默认20，最大100）
3. create_tweet: 创建新推文
4. 参数: text（必填，最多280字符）
5. reply_to_tweet: 回复推文
6. 参数: tweet_id（必填），text（必填，最多280字符）

常见问题解答

• API 限制: 免费层每月限制500条推文（用户和应用层各500条）和100次读取
• 速率限制: 服务器内置速率限制处理，包括使用量跟踪、指数退避和自动重试
• 配置问题: 确保正确配置 Twitter API 凭证和 Claude 桌面应用设置

使用教程

使用依赖

1. Node.js (v16 或更高)
2. X (Twitter) 开发者账户（免费）
3. Claude 桌面应用

安装教程

1. 克隆仓库:

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

1. 安装依赖:

npm install

1. 构建服务器:

npm run build

调试方式

1. 开发模式:

npm run dev

1. 启动服务器:

npm start

1. 测试工具:

// 示例：获取时间线
await use_mcp_tool({
  server_name: "x",
  tool_name: "get_home_timeline",
  arguments: { limit: 5 }
});

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。