X MCP Server

基本能力

产品定位

X MCP Server 是一个专为 X (Twitter) 集成设计的 MCP 服务器，主要用于与 Claude 桌面应用配合使用，提供读取时间线和与推文互动的功能。

核心功能

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

适用场景

• 个人用户管理自己的 X (Twitter) 时间线
• 开发者集成 X (Twitter) 功能到自己的应用中
• 与 Claude 桌面应用配合使用，增强社交媒体的互动能力

工具列表

1. get_home_timeline: 获取主页时间线的推文，可选参数 limit 控制获取的推文数量。
2. create_tweet: 创建新推文，必需参数 text 指定推文内容。
3. reply_to_tweet: 回复指定推文，必需参数 tweet_id 和 text。

常见问题解答

• API 限制: 免费层每月限制 500 条推文（用户和应用级别各 500）和 100 次读取。
• 速率限制: 服务器内置速率限制处理，包括使用跟踪、指数退避和自动重试。

使用教程

使用依赖

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 了解完整条款。