mobileproxy

@mobileproxy/mcp-server

mobileproxy.space 用の Model Context Protocol サーバーです。Claude Code、Claude Desktop、Cursor、Windsurf、その他の MCP 対応エージェントから、モバイルプロキシを直接操作できます。

各モバイルプロキシは、実際のキャリア IP を備えた専用の 4G/LTE モデムです。必要な期間ずっと自分専用で利用でき、必要に応じて IP をローテーションできます。一般的な用途として、特定の国やネットワークのモバイルユーザーに見える状態でのサイトやアプリのテスト、地域別の広告やローカライズされたコンテンツの確認、価格や在庫状況のモニタリング、通信のプライバシー保護などがあります。

クイックスタート

mobileproxy.space/user.html?api で API キーを取得してください。

Claude Desktop — ワンクリック

最新リリースから mobileproxy.mcpb をダウンロードし、ダブルクリックして API キーを貼り付けます。Claude Desktop には Node.js が同梱されているため、ほかにインストールするものはありません。

Claude Code

claude mcp add mobileproxy --scope user --env MOBILEPROXY_API_KEY=your_api_key -- npx -y @mobileproxy/mcp-server

--scope user を指定すると、キーはプロジェクトではなくユーザー設定に保存されるため、git に含まれることはありません。

リモートサーバー — インストール不要

ホスト型エンドポイント https://mcp.mpsapi.com/mcp では同じツールを実行できますが、2 つの違いがあります。ローカルでのみ利用できる AdsPower ブリッジは含まれず、購入、更新、チャージは残高から請求する代わりに見積もりを返します（quote_proxy_purchase、quote_renewal、quote_residential_purchase、quote_residential_topup は金額とダッシュボードへのリンクを返します）。チャットから購入するには、パッケージをローカルにインストールしてください。

• claude.ai： 設定 → コネクター → カスタムコネクターを追加 → URL https://mcp.mpsapi.com/mcp → サインインページで API キーを貼り付けます。
• Claude Code：

  claude mcp add --transport http mobileproxy https://mcp.mpsapi.com/mcp --header "Authorization: Bearer your_api_key"
  

• Cursor： {"mcpServers": {"mobileproxy": {"url": "https://mcp.mpsapi.com/mcp", "headers": {"Authorization": "Bearer your_api_key"}}}}

サーバーはキーのコピーを保持しません。各リクエストにキー、またはキーを暗号化して含む OAuth トークンが付随します。

Cursor、Windsurf、Claude Desktop（手動で JSON を設定）

{
  "mcpServers": {
    "mobileproxy": {
      "command": "npx",
      "args": ["-y", "@mobileproxy/mcp-server"],
      "env": {
        "MOBILEPROXY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）。Cursor：~/.cursor/mcp.json。

Docker

docker run -i --rm -e MOBILEPROXY_API_KEY=your_api_key ghcr.io/mobileproxy/mcp-server

MCP クライアントの設定では、"command": "docker" と "args": ["run", "-i", "--rm", "-e", "MOBILEPROXY_API_KEY", "ghcr.io/mobileproxy/mcp-server"] を使用します。

ロシア語のクイックスタート

MCP サーバーを使うと、Claude、Cursor などの AI エージェントから、mobileproxy.space のプロキシを直接操作できます。プロキシの一覧表示、IP アドレスの変更、国や通信事業者の変更、残高の確認、購入が可能です。

1. 個人アカウントで API キーを取得します。
2. インストールします。
   • Claude Desktop — 最新リリースから mobileproxy.mcpb をダウンロードし、ファイルをダブルクリックして開き、キーを入力します。
   • Claude Code — 次のコマンドを実行します。

     claude mcp add mobileproxy --scope user --env MOBILEPROXY_API_KEY=ваш_ключ -- npx -y @mobileproxy/mcp-server
     

   • インストール不要 — リモートサーバー https://mcp.mpsapi.com/mcp を使用します。claude.ai ではコネクターとして追加します（キーはログインページで入力します）。Claude Code では claude mcp add --transport http mobileproxy https://mcp.mpsapi.com/mcp --header "Authorization: Bearer ваш_ключ" を実行します。
3. エージェントに普段どおりの言葉で依頼します。
   • 「プロキシに問題はない？」
   • 「プロキシ 470663 を AdsPower にインポートする文字列を教えて」
   • 「クリーンな IP になるまで、プロキシ 470663 の IP を変更して」
   • 「カザンで空いている MegaFon のモデムはどこにある？料金はいくら？」
   • 「プロキシ 470663 を AdsPower のプロファイル jc8y5g3 に設定して」（AdsPower の起動が必要です）
   • 「プロキシ 470663 に Windows 11 の TCP フィンガープリントを設定して、サイトからどう見えるか確認して」
   • 「プロキシ 470663 をトルコに移動して」
   • 「ドイツのプロキシを 5 つ、1 週間使うといくら？」

エージェントは購入前に必ず estimate_only モードで見積もりを行い、確認を求めます。あなたが「はい」と答えるまでは、料金は請求されません。

利用可能なツール

読み取りツールは情報を参照するだけです。書き込みツールはプロキシ、その設定、または残高を変更するため、破壊的操作として注記されており、Claude などの MCP クライアントは実行前に確認を求めます。購入ツール（ローカルビルドのみ）では、ドライラン用に estimate_only: true も指定します。

アカウントとプロキシ

ツール	種類	説明
get_health_snapshot	読み取り	対応が必要な項目：期限が近いプロキシ（自動更新の状態を含む）、通信量が少ないレジデンシャルパッケージ、必要に応じてブラックリスト登録済みの IP アドレス
list_proxies	読み取り	接続情報を含むすべてのプロキシ。種類または国で絞り込み可能
get_proxy_status	読み取り	プロキシの現在の外部 IP アドレスと、任意のスパムブラックリスト確認
get_connection_string	読み取り	http:// / socks5:// URL、host:port:login:password 形式のインポート行、curl テスト、IP 変更リンク
get_balance	読み取り	RUB 建ての残高と、該当する場合はパートナーへの支払額
get_account_history	読み取り	チャージ、購入、更新、返金と領収書リンク
update_proxy_settings	書き込み	最大 100 件のプロキシの自動更新、コメント、自動 IP ローテーションタイマーを設定
change_proxy_credentials	書き込み	最大 50 件のプロキシのログイン名とパスワードを変更（情報漏えい後など）
reboot_modem	書き込み	動作が停止したモバイルプロキシのモデムを再起動（30 分に 1 回）

モバイル、サーバー、バックコネクトプロキシ

ツール	種類	説明
find_available_geo	読み取り	国または都市で利用できる無料のモデム、利用可能な通信事業者、期間ごとの料金を1回の呼び出しで取得します
get_geo_list	読み取り	すべてのロケーション（geoid、ISO、無料モデム数）。国で絞り込めます
get_price	読み取り	国ごとのすべてのレンタル期間（1/3/7/14/30/60/90/180/365 d）の料金を取得します
rotate_ip	書き込み	新しい出口IPを取得します。モバイルプロキシは通信事業者に再接続し、スティッキー型レジデンシャルプロキシは新しいピアを取得します
rotate_until_clean	書き込み	IPがスパムブラックリストに載っていない状態になるまでモバイルプロキシをローテーションします。keep_if_cleanを指定すると、現在のIPが問題なければ維持します
change_geo	書き込み	再購入せずに、プロキシを別の国または通信事業者に変更します
buy_proxy	書き込み	プロキシを購入します。残高から引き落とされます（ホスト型：quote_proxy_purchase）
renew_proxies	書き込み	最大100個のプロキシを指定期間延長します。残高から引き落とされます（ホスト型：quote_renewal）

TCP フィンガープリント（モバイルおよびサーバープロキシ）

プロキシがネットワークレベルで示すOSシグネチャ（TTL、ウィンドウ、MSS、TCPオプションの順序）を設定し、プロキシ経由のトラフィックが、たとえばWindowsデスクトップやiPhoneなど、プロキシが表すデバイスからのものに見えるようにします。

ツール	種類	説明
list_tcp_profiles	読み取り	プリセット：Android、iPhone、Windows、macOS、Linux…
get_tcp_fingerprint	読み取り	各プロキシが現在どのプロファイルを示しているかを取得します（null = ネイティブ）
set_tcp_fingerprint	書き込み	最大50個のプロキシにプロファイルを適用します。profile_id=0でネイティブに戻します。1分以内に機器に反映されます
diagnose_tcp_fingerprint	読み取り	プロキシ経由でフィンガープリント取得エンドポイントが観測する内容と、適用済みプロファイルを比較します（最大約45秒）

レジデンシャルプロキシ（タイプ3）

レジデンシャルプロキシはレンタル期間ではなくトラフィック量に応じて課金されるため、専用のプラン、ジオ設定、チャージ用ツールがあります。

ツール	種類	説明
list_residential_plans	読み取り	GBパッケージとGBあたりの料金を取得します
get_residential_locations	読み取り	ジオターゲティングで利用できる国／地域／都市／ASNを取得します
get_residential_traffic	読み取り	日ごとの使用量と消費ペースを取得します
set_residential_geo	書き込み	ジオターゲティングとローテーション／スティッキーモードを確認または変更します。無料で、元に戻せます
buy_residential	書き込み	トラフィックパッケージを購入します。残高から引き落とされます（ホスト型：quote_residential_purchase）
add_residential_traffic	書き込み	ジオ設定と接続文字列を維持したまま、パッケージにトラフィックを追加します（ホスト型：quote_residential_topup）

レジデンシャルプロキシに関する注意事項：

• ジオコードはget_residential_locationsから取得します。バックエンドは不明な値を無視し、プロキシを以前のロケーションに維持します。
• ジオを変更するとプロバイダーのログイン情報が書き換えられ、応答には新しいhttp／socks5文字列が含まれます。
• list_proxiesでは、レジデンシャルのエントリーはproxy_type: 3を持ち、2つのポートが同じ値になります（1つのポートでHTTPとSOCKS5の両方に対応）。また、residential_traffic_*のクォータブロックも含まれます。

ローカル連携

ツール	種類	説明
attach_proxy_to_adspower	書き込み	AdsPowerのブラウザープロファイルにプロキシ（およびIP変更用リンク）を書き込みます — 実験的機能、ローカルビルドのみ

attach_proxy_to_adspowerは、お使いのコンピューター上のAdsPower Local APIと通信するため、AdsPowerが起動しており、Local APIが有効になっている必要があります。AdsPowerのAPIドキュメントに基づいて実装され、テストも行われていますが、実際に稼働しているAdsPower環境ではまだ検証されていません。問題があればIssuesで報告してください。

読み取りツールは、トークンあたり約3リクエスト／秒のレート制限内に収まるよう、ジオおよび国の参照情報をキャッシュします（5～60分）。

設定

環境変数	デフォルト	用途
MOBILEPROXY_API_KEY	必須	/user.html?api で取得した API トークン
MOBILEPROXY_API_BASE	https://mpsapi.com	API ポータル。ロシアからもアクセス可能です。開発／ステージング環境では上書きしてください
MOBILEPROXY_TIMEOUT_MS	30000	HTTP リクエストのタイムアウト
MOBILEPROXY_DEBUG	0	詳細な stderr ログを出力するには 1 に設定します
ADSPOWER_API_URL	http://local.adspower.net:50325	attach_proxy_to_adspower 用の AdsPower Local API アドレス
ADSPOWER_API_KEY	未設定	AdsPower の Local API でセキュリティ検証が有効な場合のみ必要です

リモート HTTP サーバーとして実行する

npx -y @mobileproxy/mcp-server --http（または --http を指定した Docker イメージ）を実行すると、MCP を /mcp で Streamable HTTP 経由で提供します。ステートレスで、独自のキーは保持しません。クライアントは Authorization: Bearer … として API キーを送信します。また、MOBILEPROXY_OAUTH_SECRET を設定すると、claude.ai コネクター向けの OAuth 2.1 サーバーとしても動作します。Docker と nginx のセットアップ、およびすべての設定については、deploy/README.md を参照してください。

クライアントとの互換性

クライアント	対応	備考
Claude Desktop	✅	ワンクリックの .mcpb、または上記の JSON ブロック
Claude Code CLI	✅	claude mcp add ... --scope user。${env:VAR} は .mcp.json でも使用できます
Cursor	✅	設定に環境変数を直接記述します（置換には対応していません）
Windsurf	✅	Cursor と同様です
Cowork / CCD	⚠️	${env:VAR} は置換されません。ユーザースコープの設定か、システム全体の環境変数を使用してください

クライアントごとのセットアップとトラブルシューティングについては、docs/INSTALL.md を参照してください。

プライバシー

このサーバーは mobileproxy.space API 用の薄いクライアントであり、独自のトラッキング機能は追加しません。

• 処理する情報： mobileproxy.space API キーと各ツール呼び出しのパラメーターを処理し、アカウントを操作するために mobileproxy.space API（mpsapi.com）へ転送します。会話、プロンプト、ファイルを読み取ったり保存したりすることはありません。
• ローカルインストール（npm、.mcpb、Docker）： すべてお使いのコンピューター上で動作します。キーは MCP クライアントの設定または OS のキーチェーンに保存されます。
• ホスト型エンドポイント（mcp.mpsapi.com）： データベースはなく、キーのコピーも保持しません。各リクエストにはキー、またはキーを暗号化して含む OAuth アクセストークンが付与されます（AES-256-GCM。アクセストークンの有効期限は 1 時間、リフレッシュトークンの有効期限は 30 日です）。ウェブサーバーはトラブルシューティングと不正利用防止のため、標準的なアクセスログ（時刻、クライアント IP、リクエスト行、ステータス、リファラー、ユーザーエージェント）を保持します。リクエスト本文や Authorization ヘッダーは記録せず、ログは 14 日後に削除されます。
• 第三者： ありません。リクエストは mobileproxy.space API にのみ送信されます。オプションの AdsPower ブリッジは、お使いのコンピューター上の AdsPower と通信します。
• アクセスの取り消し： クライアントでコネクターを削除するか、mobileproxy.space/user.html?api で API キーを再生成してください。これにより、古いキーに基づくすべてのトークンが無効になります。
• ポリシー全文： アカウントデータについては、mobileproxy.space のプライバシーポリシーをご確認ください。お問い合わせは、mobileproxy.space のサポート、または GitHub issues までお願いします。

リンク

• インストールガイド
• 公開手順書
• MCP Registry のエントリー
• Model Context Protocol

ライセンス

MIT