A
security-
licenseA
qualityAn MCP server that allows Claude to create, manage and publish X/Twitter posts directly through the chat interface.
Last updated -
61
MIT License
X MCP 服务器
一个用于 X (Twitter) 集成的模型上下文协议 (MCP) 服务器，提供读取时间线和与推文互动的工具。专为配合 Claude 桌面使用而设计。
特征
从你的主页时间线获取推文
创建新推文
回复推文
免费 API 层的内置速率限制处理
具有完全类型安全性的 TypeScript 实现
先决条件
Node.js（v16 或更高版本）
X（Twitter）开发者账户（免费）
克劳德桌面应用程序
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
安装
克隆存储库：
git clone [your-repo-url]
cd x-mcp-server
安装依赖项：
npm install
构建服务器：
npm run build
配置
您需要设置您的 X (Twitter) API 凭证。请遵循以下步骤：
使用您的 X（Twitter）帐户登录
如果您没有开发者帐户，系统会提示您创建一个
访问免费套餐：
点击“订阅”即可获得免费访问层级
完成注册流程
创建新项目：
点击“创建项目”按钮
输入项目名称（例如“MCP Integration”）
选择“免费”作为设置
选择您的用例
点击“下一步”
在您的项目中创建一个新的应用程序：
点击“创建应用程序”
输入应用名称
点击“完成设置”
配置应用程序设置：
在您的应用程序信息中心中，点击“应用程序设置”
在“用户身份验证设置”下：
点击“设置”
启用 OAuth 1.0a
选择“Web 应用”或“原生应用”
输入任意回调 URL（例如https://example.com/callback ）
输入任意网站 URL（例如https://example.com ）
点击“保存”
设置应用权限：
在应用设置中，找到“应用权限”
更改为“读写”
点击“保存”
生成 API 密钥和令牌：
转到“密钥和令牌”选项卡
在“消费者密钥”下：
点击“查看密钥”或“重新生成”
保存您的 API 密钥和 API 密��秘密
在“访问令牌和秘密”下：
点击“生成”
确保选择具有“读写”权限的令牌
保存您的访问令牌和访问令牌密钥
重要的：
确保你的密钥和令牌安全，切勿公开分享
您将需要所有四个值：
API 密钥（也称为消费者密钥）
API 密钥秘密（也称为消费者密钥）
访问令牌
访问令牌秘密
记住免费套餐限制：
用户级别每月 500 个帖子
应用程序级别每月发布 500 篇帖子
每月阅读量 100 次
Claude桌面配置
要将 X MCP 服务器与 Claude 桌面连接，您需要在 Claude 设置中进行配置。请按照以下步骤操作：
打开文件资源管理器
导航到 Claude 配置目录：
按 Win + R
输入
%APPDATA%/Claude并按 Enter如果 Claude 文件夹不存在，请创建它
创建或编辑
claude_desktop_config.json：如果该文件不存在，则创建一个名为
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"
}
}
}
}
保存文件并重新启动Claude桌面
注意：请确保：
将所有四个凭证值替换为您的实际 API 密钥和令牌
在每个值两边添加引号 ("")
保持上面显示的精确间距和格式
使用
.json扩展名保存文件
可用工具
获取主页时间线
从您的主页时间线获取最新的推文。
参数：
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（必填）：要回复的推文的 IDtext（必填）：回复的文本内容（最多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：在监视模式下运行 TypeScriptnpm start：启动 MCP 服务器
速率限制
该服务器包括针对 X 免费层的内置速率限制处理：
每月限额：
用户级别每月 500 个帖子
应用程序级别每月发布 500 篇帖子
每月阅读量 100 次
特征：
跟踪每月使用情况
为速率限制错误提供指数退避
达到限制时清除错误消息
速率限制窗口到期后自动重试
执照
麻省理工学院
贡献
分叉存储库
创建你的功能分支（
git checkout -b feature/amazing-feature）提交您的更改（
git commit -m 'Add some amazing feature'）推送到分支（
git push origin feature/amazing-feature）打开拉取请求
Related MCP Servers
- Asecurity-licenseAqualityAn MCP server that enables Claude to interact with Twitter, allowing for posting tweets and searching Twitter content.Last updated -191306MIT License
- -security-license-qualityA Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.Last updated -210MIT License
- -security-license-qualityEnables interaction with X (formerly Twitter), allowing for posting tweets, searching content, managing accounts, and organizing lists.Last updated -23MIT License