X-Use - X (Twitter) MCP Server

x-use — X（Twitter）的 MCP 服务

将你的 AI 客户端连接到 X 研究、收件箱读取和审核后发布功能。

x-use 是一款适用于 X（Twitter）的开源 Python 模型上下文协议（MCP）服务和命令行工具。将 Claude、Codex、Cursor 或其他本地 MCP 客户端连接到个人资料研究、收件箱管理和审核后发布功能。它使用经过身份验证的浏览器会话，支持多个账号，可在本地运行，无需官方 X API 凭据。

快速开始 · 文档 · 工具参考 · 讨论 · 参与贡献

使用 x-use 可以做什么？

• **回复前先研究：**搜索 X、查看个人资料、阅读帖子和有限的线程上下文，并准备相关回复。
• **处理收件箱：**查看可见对话、未读消息、请求和通知；准备单条消息及受支持的对话操作以供审核。
• **结合上下文发布：**暂存帖子或多帖线程，检查确切文本，并在草稿准备就绪后批准。
• **在本地整理外联工作：**管理潜在客户、退订名单和活动草稿，并设置单账号限制和投递跟踪。

你的 AI 客户端负责推理和生成文本。可选的 OpenAI 兼容大模型配置支持服务端生成；常规的显式文本 MCP 工作流不需要额外的密钥。

快速开始

需要 Python 3.11+ 和 Chromium。CI 测试矩阵覆盖 Windows、macOS 和 Linux 上的 Python 3.11–3.14。

3.2.0 版提供 82 个工具，用于研究、收件箱管理、审核后发布和账号操作。升级软件包并重启 MCP 客户端，以加载当前工具。

1. 安装服务和浏览器

python -m pip install --upgrade x-use-mcp
python -m patchright install chromium

2. 选择私有数据目录并初始化

Windows PowerShell：

$env:X_USE_HOME = "$env:LOCALAPPDATA\x-use"
x-use init
x-use doctor

macOS / Linux：

export X_USE_HOME="$HOME/.local/share/x-use"
x-use init
x-use doctor

向导会配置你的账号，并从本地 JSON 导出文件导入你自己的 X 会话 Cookie。请妥善保管 Cookie 和收件箱 PIN。请在下方的客户端配置中使用相同的绝对数据目录；仅设置 shell 环境变量无法配置桌面客户端。

3. 连接 MCP 客户端

对于接受 mcpServers 对象的客户端（例如 Claude Desktop），请使用此 stdio 配置：

{
  "mcpServers": {
    "x-use": {
      "command": "/absolute/path/to/x-use",
      "args": ["mcp"],
      "env": {
        "X_USE_HOME": "/absolute/path/to/x-use-data"
      }
    }
  }
}

替换这两个路径。在 Windows 上，请使用已安装的 x-use.exe 路径，并在 JSON 中使用正斜杠，例如将 C:/Users/you/AppData/Local/x-use 作为数据目录。可在 PowerShell 中运行 Get-Command x-use，或在 macOS/Linux 上运行 command -v x-use，以查找可执行文件。

Claude Code、Codex、Cursor 和 Windsurf 各自有不同的注册位置或命令。请按照客户端设置说明操作，然后在需要时重新加载客户端。开始浏览器操作前，请让客户端调用 list_accounts。

4. 尝试第一个工作流

启用草稿模式后，向客户端提出以下请求：

检查我的账号健康状况，研究我指定的个人资料，并总结其近期公开可见的帖子。准备一条相关的回复草稿，并向我显示其 ID 和确切文本。发布前先等待我的批准。

工作流程为 get_account_health → get_profile_context → prepare_reply → reply_to_tweet → get_draft。回复工具会根据默认策略暂存草稿；prepare_reply 会提供上下文。仅在获得授权后使用 approve_draft。

更多工作流示例涵盖收件箱分类、拓展联系和帖子串。

git clone https://github.com/ihuzaifashoukat/x-use.git
cd x-use
python scripts/setup_uv.py --dev

npx skills add ihuzaifashoukat/x-use

3.2.0 版本包含 82 个工具、七个提示词、四种资源模式和七项捆绑技能。 3.1.0 在 3.0.0 的 70 个工具基础上，新增了运行时诊断、营销活动预览、书签、经审核的帖子编辑／删除、互动撤销和收件箱控制；3.2.0 在 MCP Python SDK v2 系列中保留了相同的工具。有关支持的布局和测试限制，请参阅发布和收件箱控制。

MCP 指南介绍了每个工具、提示词和资源。验证证据分别说明本地协议检查、合成浏览器固定数据和经授权的实时账户检查。

对于 uvx 客户端，请使用 uvx x-use-mcp，或固定版本并使用 uvx x-use-mcp==3.2.0。x-use-mcp 可执行文件无需参数即可启动 MCP； 现有的 x-use mcp 命令仍受支持。固定使用 3.0.0 的客户端 必须使用 uvx --from x-use-mcp==3.0.0 x-use mcp。

执行方式

当前 MCP 运行时使用异步 Patchright Chromium，并为每个账户使用独立上下文。你的配置、Cookie、草稿、队列和操作日志都存储在 X_USE_HOME 下。AI 客户端和可选模型提供商的数据处理方式取决于你选择的客户端和提供商。

协议实现使用 MCP Python SDK v2 系列（mcp>=2.3,<3）。它会与现有客户端协商 2024-11-05 至 2025-11-25 之间的握手协议版本。

普通发布默认启用草稿模式。消息、关注和线程启动都需要审批草稿。直接发布模式、显式队列处理、选择启用的自动排空功能和旧版批处理运行器使用各自独立的执行路径。更改这些设置前，请先阅读配置参考。

开发工作区会限制每个 X_USE_HOME 只能运行一个 MCP 服务进程，以防多个服务同时使用过期的草稿和队列状态。在另一个客户端中打开同一数据目录前，请先关闭现有连接。

需要了解的限制

• 浏览器读取受 X 可见内容限制。关注者、收件箱和会话线程都不是完整导出；无法获取的证据仍属未知。
• 打开会话或通知可能会更改其原生已读状态。
• 浏览器上下文重启后，加密收件箱可能需要再次输入账户所有者的 PIN。
• 分析功能目前只报告可用性和观察到的 Premium 付费限制；不提供完整的分析仪表板。
• X 布局更改、会话过期、账户验证和平台限制都可能中断工作。本地控制措施无法保证账户不会受到限制。
• 旧版 Selenium 批处理引擎（x-use run / run_cycle）独立于 MCP 草稿审核运行。目前尚未验证社区发布功能能否在异步运行时中使用。

请参阅浏览器行为与恢复和负责任使用指南。

常见问题

x-use 是否需要 X API 密钥？

不需要。它通过使用会话 Cookie 登录的浏览器操作可见的 X 页面。它不需要官方 X API 凭据。可选的服务端文本生成可能需要 LLM 提供商密钥。

哪些 MCP 客户端可以使用 x-use？

能够启动本地 stdio MCP 服务的客户端都可以使用 x-use。配置示例涵盖 Claude Desktop、Claude Code、Codex、Cursor 和 Windsurf。各客户端的发现和重新加载行为有所不同。

x-use 会自动发送所有草拟的消息吗？

不会。每条消息草稿都需要单独批准。其他写入行为取决于草稿模式、队列执行和旧版运行器；请求操作前请检查已配置的策略。

我可以管理多个 X 账户吗？

可以。每个账户都有独立的 Cookie、浏览器上下文和策略设置，还可选择代理路由。浏览器容量有限，具体取决于你的主机和配置。

我可以编辑帖子或管理 X 收件箱吗？

3.1.0 版本新增了经审核后编辑和删除自己帖子的功能，以及书签、取消关注和支持的会话请求、静音/取消静音及删除操作。编辑资格由 X 决定。收件箱历史记录并不完整，且尚未实现逐条消息编辑/删除、发送附件和群组管理。确切参数和限制请参阅控制指南。

x-use 是否免费且开源？

本项目采用 MIT 许可证，不收取项目许可费。AI 客户端订阅、可选模型提供商、代理和托管服务可能会产生各自的费用。

x-use 是否隶属于 X？

不是。x-use 是一个独立的社区项目。X 和 Twitter 是用于标识其所操作平台的名称。

这个项目以前叫 twitter-automation-ai 吗？

是的。项目在 v2 重新发布期间更名为 x-use。项目历史请参阅变更日志。

文档与社区

请从文档索引开始。索引链接到设置、工作流、工具、配置、预设、架构和故障排查。X-Use 由 Huzaifa Shoukat 维护，并欢迎社区贡献。

发现可复现的问题？报告 Bug。有工作流想分享？发起讨论。适合初次贡献的内容包括：更清晰的设置说明、虚构的浏览器测试夹具、平台修复和示例预设。

请参阅 CONTRIBUTING、行为准则和安全政策。如果 x-use 对你的工作有所帮助，请在 GitHub 上点个 Star，让更多开发者发现它。

Star 历史

许可证

MIT。