free-proxy-mcp

Litport Free Proxy MCP サーバー

ローカルで動作するstdio Model Context Protocol サーバーです。MCP クライアント（Claude Desktop、Claude Code、その他のMCP対応エージェント）に、Litportの公開無料プロキシスナップショットを使った、範囲が限定された読み取り専用の ツールを3つ提供します。検証済みのHTTP、SOCKS4、SOCKS5プロキシの一覧表示、最上位のプロキシの選択、現在のスナップショットの要約を行います。トラフィックの転送やツール呼び出し元からの任意のURLの受け付けは行わず、書き込みや副作用のあるツールも公開しません。@litportnet/free-proxy-sdkを薄くラップしたものです。

Claude Desktop、Claude Code、その他のMCPクライアントでのインストール／使用方法

クライアントのMCPサーバー設定に以下を追加してください（Claude Desktopの場合はclaude_desktop_config.json、 Claude Codeの場合は.mcp.jsonまたはclaude mcp add）：

{
  "mcpServers": {
    "free-proxy": {
      "command": "npx",
      "args": ["-y", "@litportnet/free-proxy-mcp"]
    }
  }
}

Node.js 20以降が利用可能であれば、インストール作業は必要ありません。npxが必要に応じてパッケージを取得して実行します。明示的にインストールする場合は、次のようにします：

npm install -g @litportnet/free-proxy-mcp

ツール

3つのツールはすべて読み取り専用で、同じ基盤フィルターを共有します。countryは2文字のISO 3166-1 alpha-2コード（大文字と小文字は区別されません）です。checkedWithinMinを指定すると、直近1～1440分以内にチェックされたプロキシに結果を絞り込めます。

ツール	説明	入力
list_proxies	フィルターに一致する検証済みの無料プロキシを一覧表示します。	protocol（http|socks4|socks5）、country、anonymity（transparent|anonymous|elite|unknown）、https（ブール値）、maxLatencyMs（整数 ≥ 0）、minUptime7d（整数 0～100）、minChecks7d（整数 ≥ 0）、checkedWithinMin（整数 1～1440、デフォルト30）、limit（整数 1～50、デフォルト10）
pick_best_proxies	フィルターに一致する、最上位のプロキシを返します。	count（整数 1～25、デフォルト5）、およびlimitを除くlist_proxiesと同じフィルター
proxy_snapshot_stats	現在のプロキシスナップショットを要約します。	checkedWithinMin（整数 1～1440、デフォルト30）、protocol、country

list_proxiesとpick_best_proxiesは、SDKから返されるものと同じ正規化済みレコードのproxies配列と、countを返します。 proxy_snapshot_statsは、一致する合計数、プロトコル別と匿名性別の件数、件数上位10か国、HTTPSをサポートする一致プロキシの割合、レイテンシが報告されているレコードの最小値／中央値／p90／最大値、7日間の稼働率が判明しているレコード数、最も新しいlastCheckedタイムスタンプと最も古いlastCheckedタイムスタンプを返します。すべての応答にdisclaimerフィールドが含まれます。基盤となるSDKのエラー（無効なフィルター、リクエストのタイムアウト、不正な形式または古いスナップショット）は、スローされずに{ isError: true, content: [...] }として返され、スタックトレースが含まれることはありません。

環境

変数	デフォルト	用途
LITPORT_FREE_PROXY_API_URL	SDK組み込みのスナップショットURL	スナップショットエンドポイントの絶対http://またはhttps:// URLです。サーバーはこの値を検証し、別の値が設定されている場合は、起動時に明確なエラーを出して終了します。
LITPORT_FREE_PROXY_TIMEOUT_MS	10000	SDKクライアントに渡される、リクエストごとのタイムアウト（ミリ秒）です。

テスト

npm install
npm test

npm testは、test/*.test.mjsに対してnode --testを実行します。MCP SDKのメモリ内トランスポートを通じて、注入された@litportnet/free-proxy-sdkクライアントでサーバーを実行するインプロセスのユニットテスト、ローカルHTTPフィクスチャサーバーを使用してstdio経由でサーバーを起動するエンドツーエンドテスト、さらにnpxと同様にbinシンボリックリンク経由でサーバーを起動する回帰テストが含まれます。

リソース

• 無料プロキシリスト
• APIドキュメント
• SDKのソース

無料プロキシはテスト専用です。認証情報、Cookie、決済データ、個人データを経由させないでください。