X Browser MCP

x-browser-mcp

英语 | 简体中文

x-browser-mcp 允许本地代理从真实登录的浏览器会话中读取X（推特）。

它是一个浏览器支持的MCP服务器，用于Claude Code、Codex和其他具有MCP功能的本地代理需要新的X信号而无需支付官方X API的费用的工作流。

它的作用

• 检查本地X会话是否就绪
• 需要时启动交互式登录流程
• 读取X主页时间线
• 搜索最近的X讨论
• 通过MCP和普通HTTP公开相同的功能

运作原理

x-browser-mcp 是围绕一个独立的浏览器配置文件构建的。

• MCP/HTTP服务可以在后台继续运行
• 只有当请求实际需要X访问时，才会启动浏览器
• 手动登录始终会打开一个可见的浏览器窗口
• 正常读取可以在无头模式下对相同的隔离配置文件运行

这使服务可供本地代理使用，而不会强制永久浏览器进程保持活动状态。

为什么存在

官方的X API对于许多个人工作流程来说是昂贵的，并且通常与您在真实浏览器会话中直接看到的内容不太一致。

这个项目采取了不同的路线：

• 浏览器支持而不是API支持
• 本地会话重用，而不是开发人员API凭据
• MCP原生，因此本地代理可以直接调用它

工具

MCP服务器公开了这些工具：

• check_login_status
• start_login
• read_home_timeline
• search_x

HTTP API

• GET /health
• GET /api/v1/login/status
• POST /api/v1/login/start
• GET /api/v1/home?limit=10
• POST /api/v1/search
• POST /mcp

登录模型

登录流程故意简单：

1. 呼叫 start_login
2. 在隔离的配置文件上打开一个可见的浏览器窗口
3. 在该窗口中完成X登录
4. 以后的请求重用相同的配置文件

如果会话已经有效，服务可以继续使用存储的配置文件，而无需再次请求登录。

快速开始

1.建造

go build -o x-browser-mcp .

2.运行服务器

./x-browser-mcp -port :18110

3.需要时开始登录

curl -X POST http://127.0.0.1:18110/api/v1/login/start

4.检查状态

curl http://127.0.0.1:18110/api/v1/login/status

5.搜索X

curl -X POST http://127.0.0.1:18110/api/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"model context protocol","mode":"latest","limit":5}'

6.阅读主页时间线

curl 'http://127.0.0.1:18110/api/v1/home?limit=10'

客户端集成

x-browser-mcp 与可以与可流式传输的HTTP MCP端点通信的MCP客户端配合使用。

这包括：

• 克劳德代码
• 法典
• OpenClaw ACP/acpx支持的会话

克劳德法典

将您的MCP客户端指向：

http://127.0.0.1:18110/mcp

开爪

OpenClaw可以通过ACPX连接到此服务器 mcp-remote.

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "mcpServers": {
            "x-browser-mcp": {
              "command": "npx",
              "args": [
                "-y",
                "mcp-remote@latest",
                "http://127.0.0.1:18110/mcp"
              ]
            }
          }
        }
      }
    }
  }
}

操作说明

• 这个项目是供当地个人使用的
• 这取决于真实的浏览器会话和本地浏览器状态
• 它使用独立的浏览器配置文件，而不是您正常的日常浏览器配置文件
• 它不依赖于官方的X API

存储库范围

此存储库仅包含MCP服务器。

它不包括：

• 浏览器配置文件数据
• 本地Cookie
• launchd用户代理
• 个人Claude/Codex/OpenClaw配置文件