Proxy302

proxy302-mcp

Proxy302 チームが開発・保守する公式 Proxy302 MCP サーバーです。アカウント、請求、接続に関するお問い合わせはProxy302 サポートまで、このサーバーのバグについてはGitHub のイシューを作成してください。

AI アシスタントに、本物のレジデンシャルプロキシツールボックスを与えましょう。proxy302-mcp はProxy302向けのModel Context Protocolサーバーです。Claude Code、Claude Desktop、Cursor、その他の MCP クライアントから、トラフィックと使用状況を確認したり、国やプランを閲覧したり、任意の国のローテーション型レジデンシャルプロキシ URL を取得したり、プロキシと静的 IP を一覧表示したり、プロキシ経由でウェブページを取得したりできます。

中文说明

v1 は意図的に読み取り専用で、費用が発生しない設計です。購入、更新、チャージは一切行いません。実行できる唯一の書き込み操作（動的プロキシ認証情報の作成）は無料で、デフォルトでは無効になっており、実際に使用した場合にのみトラフィック料金が発生します。

ホステッドサーバー（インストール不要）

Proxy302 がこのサーバーをホストして実行します。まずProxy302 コンソールで API キーを作成してください。

ワンクリックで https://mcp.proxy302.com/mcp が追加されます。続いてアプリに Proxy302 のサインインウィンドウが表示されるので、API キー（key id:secret）を一度だけ貼り付けます。コンソールでキーを削除すると、接続が解除されます。

• Claude（claude.ai、Claude Desktop）：Settings → Connectors → Add custom connector を選び、URL に https://mcp.proxy302.com/mcp を指定します。
• ChatGPT（開発者モード）：同じ URL と OAuth を使用してコネクターを作成します。
• **Cursor、VS Code、Windsurf、その他の MCP クライアント：**同じ URL を使用します。ヘッダーは不要です。

**OAuth でサインインする場合：**Claude、ChatGPT、または MCP サインインに対応するクライアントに、https://mcp.proxy302.com/mcp をカスタムコネクターとして追加し、サインインウィンドウで API キーを一度だけ貼り付けます。Claude Code では次のようにします。

claude mcp add --transport http proxy302 https://mcp.proxy302.com/mcp

続いて Claude Code で /mcp を実行し、サインインします。

または、キーをヘッダーとして送信します：https://proxy302.com/v1/mcp を使用し、Authorization: Bearer <key id>:<secret> を指定します。

claude mcp add --transport http proxy302 https://proxy302.com/v1/mcp --header "Authorization: Bearer <key id>:<secret>"

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "proxy302": {
      "url": "https://proxy302.com/v1/mcp",
      "headers": { "Authorization": "Bearer <key id>:<secret>" }
    }
  }
}

ホステッドサーバーには fetch_url を除く同じツールに加え、rotate_ip（スティッキープロキシの新しい出口 IP）、check_ip_purity（静的 IP のブロックリストスコア、または指定したロケーションから次に割り当てられる IP のスコア）、estimate_cost（ウォレット残高に基づくプランの見積もり）が用意されています。こちらも費用は発生しません。

ローカルで実行する

1. Proxy302 コンソールで API キーを作成し、キー ID とシークレットを控えておきます。
2. インストールします。

claude mcp add proxy302 -e PROXY302_API_KEY="<key id>:<secret>" -- npx -y github:proxy302/proxy302-mcp

Node.js 20 以降が必要です。

特典：proxy302-mcp 経由の呼び出しが初めて成功した際、Proxy302 が有料アカウントに 1 PTC を付与します（アカウントごとに 1 回）。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": ["-y", "github:proxy302/proxy302-mcp"],
      "env": { "PROXY302_API_KEY": "<key id>:<secret>" }
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）：

{
  "mcpServers": {
    "proxy302": {
      "command": "npx",
      "args": ["-y", "github:proxy302/proxy302-mcp"],
      "env": { "PROXY302_API_KEY": "<key id>:<secret>" }
    }
  }
}

ツール

ツール	機能
get_account_usage	アカウント、ウォレット（PTC）残高、プリペイド通信量の残量、プールごとの残高、および過去 N 日間の日次使用量
list_countries	接続先として指定できる国と、その ID および ISO コード（名前で絞り込み可能）
list_regions	国の州、または州の都市
list_products	製品ラインと固定 IP プラン（データセンターおよび住宅用）
get_dynamic_proxy	国（対応している場合は州／都市）に対応した、すぐに使えるローテーション型住宅用 URL http://user:pass@host:port。既存のプロキシを再利用します。create_if_missing=true を指定すると新規作成します
list_my_proxies	お客様の動的プロキシと固定 IP。指定がない限り、パスワードはマスキングされます
fetch_url	プロキシ経由で URL にリクエストを送信し（必要に応じて指定した国から）、Markdown、テキスト、または生データを返します

意図的に v1 には含めていません：購入、更新、チャージ。

使用例

アシスタントに次のように依頼します：

• 「プロキシの通信量はあとどれくらい残っていますか？ 今週はどれくらい使いましたか？」
• 「利用できる国はどこですか？ ドイツのプロキシを取得してください。」
• 「米国の出口経由で https://example.com/pricing を取得して、要約してください。」
• 「今後 7 日以内に有効期限が切れる固定 IP を一覧表示してください。」

Playwright でプロキシを使用する

get_dynamic_proxy はホスト、ポート、ユーザー名、パスワードを返します：

import { chromium } from 'playwright';

const browser = await chromium.launch({
  proxy: { server: 'http://HOST:PORT', username: 'USERNAME', password: 'PASSWORD' },
});
const page = await browser.newPage();
await page.goto('https://ipinfo.io/json');
console.log(await page.textContent('body'));

browser-use でプロキシを使用する

from browser_use import Agent, Browser, BrowserConfig

browser = Browser(config=BrowserConfig(
    proxy={"server": "http://HOST:PORT", "username": "USERNAME", "password": "PASSWORD"},
))
agent = Agent(task="Open ipinfo.io and tell me the country", llm=llm, browser=browser)

fetch_url は JavaScript をレンダリングしない通常の HTTP リクエストです。JavaScript を多用するサイトでは、上記のようにプロキシ URL をブラウザーに渡してください。

設定

変数	意味
PROXY302_API_KEY	必須。<key id>:<secret>、または Basic ... トークン
PROXY302_API_SECRET	任意。PROXY302_API_KEY にキー ID のみを設定する場合に使用します
PROXY302_BASE_URL	任意。デフォルトは https://proxy302.com です

認証情報は環境変数からのみ読み込まれます。決してコミットしないでください。リクエストには User-Agent: proxy302-mcp/<version> と X-Proxy302-Client が付与されます。

開発

npm install
npm run build
npm test
PROXY302_API_KEY="<id>:<secret>" npm run smoke   # read-only checks against the live API

ライセンス

MIT