漫游 Roam MCP 服务器

发布:2026 年 10 月 9 日 · 版本 0.1.0 · MIT 开源协议

可以这样跟智能体说

• "用洛杉矶的美国住宅 IP 打开这个商品页,告诉我价格。"
• "对比一下 google.de 和 google.fr 搜 running shoes 的结果有什么不同。"
• "给我一个固定的英国代理,顺便写好 Playwright 的启动代码。"
• "查一下日本会话的出口 IP 和运营商。"
• "我的 Roam 账户还剩多少余额?"

工具一览

工具	作用
fetch_url	用指定地区的代理 IP 抓取网址,返回 HTTP 状态码和正文(markdown、纯文本或 HTML)。
get_proxy	生成可直接使用的 http:// 或 socks5:// 代理串,附带 Playwright 配置,轮换或固定都行。
check_ip	查看某个地区或会话的出口 IP、城市、地区和运营商。
account_status	钱包余额、每 GB 价格、最近 7 天用量和已租的静态 IP。

每个工具都支持同一组地区参数:country(us、de、jp…)、state(ca、ny…,美国州也可以填全名)、city、session(同一个 id 保持同一个 IP;不填就每次轮换)、product(residential 住宅、datacenter 机房、mobile 移动)。

两分钟接好

1. 拿到 API token

1. 登录用户中心(还没有账号就先注册)。
2. 左侧菜单打开动态住宅。
3. 切到API / 代码接入标签,复制顶部的 token。

2. 把服务器加到客户端

需要 Node.js 20 或更新版本。把 your_token 换成第 1 步拿到的 token。

Claude Code

claude mcp add roamproxy -e ROAM_API_TOKEN=your_token -- npx -y roamproxy-mcp

Claude Desktop:下载 roamproxy-mcp.mcpb,双击安装,按提示粘贴 token 即可。也可以把下面的 JSON 加进 claude_desktop_config.json。

Cursor、Windsurf、Claude Desktop(JSON 配置)

{
  "mcpServers": {
    "roamproxy": {
      "command": "npx",
      "args": ["-y", "roamproxy-mcp"],
      "env": { "ROAM_API_TOKEN": "your_token" }
    }
  }
}

VS Code(.vscode/mcp.json)

{
  "servers": {
    "roamproxy": {
      "command": "npx",
      "args": ["-y", "roamproxy-mcp"],
      "env": { "ROAM_API_TOKEN": "your_token" }
    }
  }
}

工作原理

服务器跑在你自己的电脑上。智能体调用 fetch_url 时,请求从你的电脑发到 Roam 网关(gw.roamproxy.com:41080),再由网关从你指定地区的 IP 转发出去。网关和按 GB 计费都与手动配代理完全一样,MCP 服务器只是替智能体省掉了手动拼用户名这一步。

API token 只能拿到你自己的代理凭据和账户概况,别的什么都做不了:不能充值、不能买静态 IP、不能改设置。

常见问题

MCP 服务器要钱吗?

服务器本身免费开源(MIT)。它产生的流量按正常价格从你的 Roam 钱包扣:动态住宅 $2/GB(大额充值最低 $1.20/GB),动态机房 $0.8/GB。无订阅、无最低消费,余额不过期。

智能体拿着我的 API token 能做什么?

只能使用你的代理,以及读取余额、用量和静态 IP 列表。token 不能充值、不能买静态 IP、不能改设置,也碰不到别的账号。随时可以在用户中心重置,旧 token 立即失效。

fetch_url 在哪里运行?

在你自己的电脑上。服务器把请求发到 Roam 网关,网关从你指定地区的 IP 转发出去。Roam 不托管浏览器,也不保存网页内容。

指定了城市,结果落到了别的地方。

某个城市当下没有可用 IP 时,网关会退到同一个州,再退到同一个国家,而不是直接报错。用 check_ip 可以看到会话实际落在哪。美国的州既可以填缩写(ca),也可以填全名(California)。

其他接入方式

不用 AI 智能体?同样的代理到处都能用:Firefox 和 Edge 的浏览器扩展,Python、Node、Go、curl 的代码示例,以及 Python SDK。

漫游 Roam 就是这个服务器背后的出口 IP:动态住宅 $2/GB,动态机房 $0.8/GB,静态住宅 $4/IP/月,无月最低消费。注册一个账号,几分钟后你的智能体就能从新的国家上网。