🚀 X MCP 服务器
X MCP 服务器是一款用于集成 Twitter 和 Claude 桌面应用的工具。它具备获取推文、发布新推文以及回复推文等功能，同时还内置了速率限制处理功能，能有效保障使用的稳定性和合规性。
🚀 快速开始
X MCP 服务器的使用非常便捷，你可以按照以下步骤快速搭建并运行：
- 克隆此仓库到本地。
- 打开终端，进入项目目录。
- 运行
npm run build构建 TypeScript 代码。 - 选择开发模式（带自动监听）运行
npm run dev，或者选择生产模式运行npm start。
📦 安装指南
下载代码
- 克隆此仓库到本地。
- 打开终端，进入项目目录。
构建
运行以下命令构建 TypeScript 代码：
npm run build
运行
- 开发模式（带自动监听）：
npm run dev - 生产模式：
npm start
✨ 主要特性
功能丰富
- 获取主页推文：可获取你关注的用户最新发布的推文，还能通过
limit参数指定获取数量。 - 发布新推文：支持发布最多 280 个字符的新推文。
- 回复推文：能针对指定的推文进行回复，回复内容同样最多 280 个字符。
速率限制处理
内置了针对 Twitter 免费 tier 的速率限制功能：
- 每月限制：
- 用户级：每月最多 500 次发布操作。
- 应用级：每月最多 500 次发布操作。
- 读取操作：每月最多 100 次。
- 特性：
- 跟踪每月使用量。
- 提供指数回退功能以处理速率限制错误。
- 达到限制时会给出清晰的错误消息。
- 自动重试直到速率限制窗口过期。
💻 使用示例
基础用法
获取主页推文
await use_mcp_tool({
server_name: "x",
tool_name: "get_home_timeline",
arguments: { limit: 5 }
});
发布新推文
await use_mcp_tool({
server_name: "x",
tool_name: "create_tweet",
arguments: { text: "Hello from MCP! 🤖" }
});
回复推文
await use_mcp_tool({
server_name: "x",
tool_name: "reply_to_tweet",
arguments: {
tweet_id: "1234567890",
text: "Great tweet! 👍"
}
});
📚 详细文档
配置
环境变量
在 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"
}
}
}
}
开发
构建
npm run build
开发模式
npm run dev
运行服务器
npm start
贡献指南
- 叉仓库。
- 创建你的功能分支（
git checkout -b feature/amazing-feature）。 - 提交更改（
git commit -m 'Add some amazing feature'）。 - 推送到分支（
git push origin feature/amazing-feature）。 - 打开 Pull Request。
📄 许可证
本项目采用 MIT 许可证。
⚠️ 重要提示
请勿泄露你的 API 凭据。
💡 使用建议
建议将敏感信息加密存储。