NodeMaven

nodemaven-mcp

NodeMaven のレジデンシャルプロキシ向け MCP サーバーです。 AI アシスタントで、地域ターゲティングやスティッキーセッションに対応したプロキシ文字列を作成したり、プロキシへの接続と接続元の出口を確認したり、サイトに対してテストしたり、ロケーションを検索したり、トラフィック使用量を確認したり、サブユーザーやホワイトリスト登録済み IP を管理したりできます。

デフォルトでは読み取り専用です。アカウントを変更するツールは、書き込みを許可するまで実行できません。

ツール

ツール	機能
proxy_url	国、地域、都市、ISP を指定したプロキシ文字列を生成します。任意でスティッキーセッションとその有効期間も指定できます。HTTP または SOCKS5 に対応しています。
check_proxy	プロキシ経由で 1 回接続し、ステータス、出口 IP、所要時間を返します。
test_proxy_on_site	プロキシ経由でサイトのページを 1 ページリクエストし、ステータス、サイズ、所要時間、およびブロックされているように見えるか（403、429、CAPTCHA、チャレンジページ）を報告します。ページは返されません。
list_locations	ターゲティングに利用できる国、地域、都市、ISP と、proxy_url で指定するコードを表示します。
account_status	残りのトラフィック、サブスクリプションのステータス、トラフィックが凍結されているかどうかを表示します。
traffic_stats	期間ごとのトラフィック使用量を表示します。
top_domains	プロキシ経由でアクセスしたドメインと、ドメインごとのトラフィックを表示します。
list_sub_users	使用量と制限を含むサブユーザーの一覧を表示します。
list_whitelist_ips	パスワードなしでプロキシを使用できる IP アドレスを表示します。

以下のツールはアカウントを変更するため、NODEMAVEN_MCP_ALLOW_WRITE=1 の場合にのみ動作します。

ツール	機能
create_sub_user	専用のプロキシログインと任意のトラフィック制限を持つサブユーザーを作成します。パスワードはサーバーが生成します。
update_sub_user	サブユーザーのトラフィック制限を変更するか、制限を有効または無効にします。
reset_sub_user_usage	記録されたサブユーザーのトラフィックをゼロに戻します。
delete_sub_user	サブユーザーを削除します。
add_whitelist_ip	ポート数と任意のターゲティングを指定して、パスワードなしでプロキシを使用できる IP アドレスを追加します。
remove_whitelist_ip	ホワイトリストからアドレスを削除します。

支払い、プラン、API キーを扱うツールはありません。

セットアップ

NodeMaven のダッシュボードから API キーを取得してください。プロキシのユーザー名とパスワードは、そのキーを使ってアカウントから読み取られるため、ほかに必要なものはありません。

Claude Desktop（claude_desktop_config.json）、Cursor、その他の MCP クライアント：

{
  "mcpServers": {
    "nodemaven": {
      "command": "uvx",
      "args": ["nodemaven-mcp"],
      "env": { "NODEMAVEN_APIKEY": "your-api-key" }
    }
  }
}

uv を使用しない場合は、pip install nodemaven-mcp を実行し、"command": "nodemaven-mcp" を使用してください。

変数
NODEMAVEN_APIKEY	必須です。
NODEMAVEN_LOGIN, NODEMAVEN_PASSWORD	任意です。アカウント自体の認証情報の代わりに使用するプロキシ認証情報です。たとえばサブユーザーを指定できます。
NODEMAVEN_MCP_ALLOW_WRITE	1 を指定すると、アカウントを変更するツールが使用できます。デフォルトでは無効です。
NODEMAVEN_MCP_REVEAL_PASSWORD	1 を指定すると、proxy_url と create_sub_user の出力に実際のパスワードが含まれます。デフォルトでは無効です。

認証情報

ツールの結果はモデルのコンテキストに入り、通常はチャット履歴にも残るため、サーバーは秘密情報が結果に含まれないようにしています。

• NODEMAVEN_MCP_REVEAL_PASSWORD=1 が設定されていない場合、proxy_url と create_sub_user はパスワードを <PROXY_PASSWORD> として返します。
• API レスポンスは固定されたフィールドの一覧に絞られます。プロキシのパスワードとアカウントのメールアドレスは返されません。
• test_proxy_on_site はページの内容を返さず、接続エラーからプロキシのパスワードを削除します。

開発

uv sync
uv run pytest

nodemaven Python SDK を基盤にしています。

ライセンス

MIT