190カ国以上のレジデンシャル、データセンター、モバイルプロキシIPを使用して、AIエージェントによるウェブブラウジングを可能にします。
別名 roamproxy/roamproxy-mcp, roamproxy-mcp
- スター
- 0
- ツール
- 4
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.1
- 最終コミット
- 2026年10月10日
- ライセンス
- MIT
RoamProxy MCPとは
190カ国以上のレジデンシャル、データセンター、モバイルプロキシIPを使用して、AIエージェントによるウェブブラウジングを可能にします。 4個のツールを提供しており、fetch_url, get_proxy, check_ipなどがあります。
プロジェクトのREADMEから生成された概要
RoamProxy MCP server について
RoamProxyは、190カ国以上のレジデンシャル、データセンター、およびモバイルIPアドレスを使用して、AIエージェントがインターネットを閲覧できる機能を提供します。このMCP serverは、Claude、Cursor、Windsurf、VS CodeなどのクライアントをRoamProxyゲートウェイに接続し、モデルが特定の地理的場所からウェブコンテンツにアクセスできるようにします。ユーザーは、アカウント認証およびプロキシサービスへのアクセスのために、環境変数を通じてRoamProxy APIトークンを提供する必要があります。
このサーバーには、ウェブ操作およびアカウント管理のための専用ツールが含まれています。fetch_urlツールは、選択した国、州、または都市を経由して、ウェブサイトのコンテンツをmarkdown、text、またはHTMLとして取得します。get_proxyツールは、Playwrightの設定を含む、すぐに使用可能なHTTPまたはSOCKS5 URLを生成します。また、check_ipを使用して出口の場所とISPを確認したり、account_statusを使用してウォレットの残高や使用統計を監視したりすることも可能です。通信コストは、データ消費量に基づいてユーザーのRoamProxyウォレットに直接請求されます。
できること
- 1ローカライズされたウェブスクレイピング特定の都市のレジデンシャルIPを使用して、特定の製品ページにアクセスし、価格を確認するようエージェントに指示します。
- 2国をまたいだ検索結果の比較地域による違いを確認するために、異なる国間での検索エンジンの結果を比較するようAIに依頼します。
- 3ブラウザ設定の自動化Playwrightテストツールで使用するための、特定のプロキシURLと設定を生成します。
- 4アカウントと使用状況の監視データ消費量を管理するために、プロキシアカウントの残高を確認します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
RoamProxy MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにRoamProxy MCPをインストール
$ claude mcp add --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp -- npx -y roamproxy-mcpCursorにRoamProxy MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}VS CodeにRoamProxy MCPをインストール
.vscode/mcp.json
{
"servers": {
"roamproxy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}VS Code CLIにRoamProxy MCPをインストール
$ code --add-mcp '{"name":"roamproxy-mcp","type":"stdio","command":"npx","args":["-y","roamproxy-mcp"],"env":{"ROAM_API_TOKEN":"<YOUR_ROAM_API_TOKEN>"}}'Claude DesktopにRoamProxy MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}CodexにRoamProxy MCPをインストール
$ codex mcp add roamproxy-mcp --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' -- npx -y roamproxy-mcpCodex config.tomlにRoamProxy MCPをインストール
~/.codex/config.toml
[mcp_servers.roamproxy-mcp] command = "npx" args = ["-y", "roamproxy-mcp"] [mcp_servers.roamproxy-mcp.env] ROAM_API_TOKEN = "<YOUR_ROAM_API_TOKEN>"
Gemini CLIにRoamProxy MCPをインストール
$ gemini mcp add -s user -e 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp npx -- -y roamproxy-mcpGemini settings.jsonにRoamProxy MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}RoamProxy MCPツール 4
READMEから検出fetch_urlget_proxycheck_ipaccount_status
| fetch_url | — | |
| get_proxy | — | |
| check_ip | — | |
| account_status | — |
設定
ROAM_API_TOKEN必須シークレットYour RoamProxy API token (member dashboard > Rotating residential > API)
| 名前 | 説明 | 種類 |
|---|---|---|
| ROAM_API_TOKEN | Your RoamProxy API token (member dashboard > Rotating residential > API) | 必須シークレット |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能roamproxy/roamproxy-mcp is public and reachablegithub.com/roamproxy/roamproxy-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定roamproxy-mcp names roamproxy/roamproxy-mcp as sourcenpmjs.com/package/roamproxy-mcp ↗合格
- ビルドの来歴 (Sigstore 証明)Sigstore attestation for roamproxy-mcpnpmjs.com/package/roamproxy-mcp/v/0.1.1#provenance ↗合格
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-10github.com/roamproxy/roamproxy-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from roamproxy-mcp合格
- パッケージおよびその依存関係に重大な勧告なし102 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない4 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るRoamProxy MCP Server
An MCP server that lets AI agents (Claude, Cursor, VS Code, Windsurf, …) browse the web through RoamProxy residential, datacenter and mobile IPs in 190+ countries.
Ask your agent things like:
- "Open this product page from a US residential IP in Los Angeles and summarise the price."
- "Compare what google.de and google.fr show for 'running shoes'."
- "Give me a sticky UK proxy for Playwright."
- "How much balance is left on my RoamProxy account?"
Tools
| Tool | What it does |
|---|---|
fetch_url |
Fetch a URL through a proxy IP in the chosen country / state / city. Returns status + body as markdown, text or HTML. |
get_proxy |
Build a ready-to-use http:// or socks5:// proxy URL (plus Playwright config) for any geo, rotating or sticky. |
check_ip |
Show the exit IP, city, region and ISP for a geo/session, to verify targeting. |
account_status |
Wallet balance, per-GB prices, last 7 days of usage, rented static IPs. |
Geo options on every tool: country (us, de, jp…), state (ca, ny… or full US state names), city (Los Angeles), session (same id = same IP; omit to rotate), product (residential default, datacenter, mobile).
Setup
- Create an account at roamproxy.com and copy your API token from the member dashboard (Rotating residential page, API section).
- Add the server to your client. Requires Node.js 20+.
Claude Code
claude mcp add roamproxy -e ROAM_API_TOKEN=your_token -- npx -y roamproxy-mcp
Claude Desktop / Cursor / Windsurf (claude_desktop_config.json, ~/.cursor/mcp.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" }
}
}
}
Pricing
Traffic is billed to your RoamProxy wallet exactly as if you used the proxy directly — the MCP server itself is free and open source. Residential $2/GB (down to $1.20/GB with volume top-ups), datacenter $0.80/GB, balance never expires. See pricing.
How it works
fetch_url runs on your machine: the request goes to the RoamProxy gateway (gw.roamproxy.com:41080) and leaves from a residential IP in the location you asked for. Your token only unlocks your own proxy credentials and account info — it cannot top up, buy or change anything.
If a city has no stock the gateway falls back to the state, then the country, instead of failing; check_ip shows where you actually landed.
Development
npm install
npm test # offline unit tests
ROAM_API_TOKEN=... node test/e2e.mjs # live check, uses a little traffic
Related
- proxy-examples — code samples for Python, Node, Go, curl
- roamproxy-python — Python SDK
- proxyprobe — proxy checker CLI
MIT © Goldkeep Digital LLC
RoamProxy MCPのよくある質問
RoamProxy MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp -- npx -y roamproxy-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
RoamProxy MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
RoamProxy MCPが提供するツールは
4個のツールを提供しており、fetch_url, get_proxy, check_ip, account_statusなどがあります。
MCP serverの料金はいくらですか?
MCP serverは無料のオープンソースですが、通信トラフィックについては標準料金に基づきRoamProxyウォレットに課金されます。
特定の都市が利用できない場合はどうなりますか?
特定の都市の在庫がない場合、ゲートウェイはエラーを返す代わりに、自動的に州または国レベルのプロキシにフォールバックします。