atheris-mcp

atheris-mcp

Atheris プロキシ向けの MCP サーバーです。実在の通信事業者が提供する 4G／5G モバイル IP と住宅用 IP を、ギガバイト単位で利用できます。エージェントが特定の国の IP 経由でトラフィックをルーティングするための、完全に自律的な方法を提供します。リアルタイムの在庫確認、すぐに使えるプロキシ URL の取得、残りの GB 数の確認を、すべてツール呼び出しで行えます。

依存関係はありません。ファイルは 1 つです。Node ≥ 18。

ツール

• atheris_stock — 国とプール（mbl = モバイル、peer = 住宅用）ごとのリアルタイムなプロキシ在庫です。キーは不要です。まずこれを呼び出して、容量のある国を選びます。
• atheris_proxy_url — 国／プール／セッション／ローテーションを指定して、すぐに使える http:// または socks5:// プロキシ URL を取得します。任意の HTTP クライアントにそのまま渡せます。
• atheris_usage — キーの残り GB 数と有効期限を確認します。

セットアップ

Atheris ダッシュボードから Atheris アクセスキー（pak_…）を取得してください。

npm（atheris-mcp。公式 MCP レジストリでは io.github.atheris-ee/atheris-mcp としても公開されています）から：

// Claude Desktop / Claude Code / Cursor / any MCP client
{
  "mcpServers": {
    "atheris": {
      "command": "npx",
      "args": ["-y", "atheris-mcp"],
      "env": { "ATHERIS_PROXY_KEY": "pak_your_key_here" }
    }
  }
}

GitHub から直接取得する方法もあります："args": ["-y", "github:atheris-ee/atheris-mcp"]。

または、ローカルのチェックアウトから：

{
  "mcpServers": {
    "atheris": {
      "command": "node",
      "args": ["/path/to/atheris-mcp.mjs"],
      "env": { "ATHERIS_PROXY_KEY": "pak_your_key_here" }
    }
  }
}

環境変数：

• ATHERIS_PROXY_KEY — pak アクセスキーです（atheris_proxy_url と atheris_usage には必須です。atheris_stock はキーなしで動作します）。
• ATHERIS_API_BASE — デフォルトは https://atheris.ee/api/v1 です。キーは Bearer トークンとしてここで指定したホストに送信されるため、信頼できるホストのみを指定してください。

このキーはプロキシのパスワードとしても使われる認証情報です。パスワードと同様に扱ってください。コマンドの引数ではなく env に保管し、漏えいした場合はダッシュボードからローテーションしてください。サーバーが通信するのは atheris.ee（または指定した ATHERIS_API_BASE）のみで、テレメトリーは収集しません。

atheris_proxy_url の結果も秘密情報です。 proxy_url と password の両フィールドに pak キーが含まれます。キーそのものと同様に扱い、ツールの出力をログに記録したり、共有のトランスクリプトに貼り付けたりしないでください。

セッションのルール（重要）

atheris_proxy_url を呼び出すたびに session ID を指定します。同じ session ID を指定すると、同じ出口 IP が返されます。 多数の並列 ID（異なるホストのスクレイピングや、多数のアンチディテクトプロファイルの実行など）を扱う場合は、それぞれの ID に独自の session ID を割り当ててください。1 つのスティッキーセッションを再利用すると、すべての ID が 1 つの出口に固定されます。接続のたびに新しい出口を使いたい場合は、rotation: "hard" を指定してください。

基盤となる HTTP API

このサーバーは、Atheris JSON API（pak キーを使った Bearer 認証）の薄いラッパーです。

• GET /api/v1/stock
• GET /api/v1/proxy?country=us&pool=mbl&session=<id>&rotation=sticky&protocol=http
• GET /api/v1/usage

プログラムからのアクセス購入方法を含むエージェント向けリファレンス全体については、https://atheris.ee/llms-full.txt をご覧ください。

ライセンス

MIT © Arvane Holdings OÜ