atheris-mcp

atheris-mcp

适用于 Atheris 代理的 MCP 服务——按 GB 计费的真实运营商 4G/5G 移动 IP 和住宅 IP。它为 Agent 提供了一种完全自主的方式，可通过特定国家/地区的 IP 路由流量：查询实时库存、获取可直接使用的代理 URL，并查看剩余 GB 数——全部通过工具调用完成。

零依赖。单文件。Node ≥ 18。

工具

• atheris_stock — 按国家/地区和代理池查询实时代理库存（mbl = 移动，peer = 住宅）。无需密钥。先调用此工具，选择有可用容量的国家/地区。
• atheris_proxy_url — 获取适用于指定国家/地区、代理池、会话和轮换方式的 http:// 或 socks5:// 代理 URL。可直接交给任何 HTTP 客户端。
• atheris_usage — 查询密钥剩余的 GB 数和到期时间。

设置

你需要从 dashboard 获取 Atheris 访问密钥（pak_…）。

通过 npm 安装（atheris-mcp，也已收录于官方 MCP registry，名称为 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 中，而不是命令参数里；如果泄露，请通过 dashboard 更换。此服务只会与 atheris.ee（或你的 ATHERIS_API_BASE）通信，不会收集遥测数据。

atheris_proxy_url 的结果也属于机密。 其中的 proxy_url 和 password 字段都包含你的 pak 密钥——请像保护密钥本身一样保护工具输出：不要记录，也不要粘贴到共享的对话记录中。

会话规则（重要）

每次调用 atheris_proxy_url 都需要提供一个 session ID。相同的 session ID 会返回相同的出口 IP。 如果需要多个并行身份（例如抓取不同的主机、运行多个反检测配置），请为每个身份分配独立的 session ID——多个身份复用一个粘性会话，会使它们全部固定到同一个出口 IP。若要在每次连接时获取新的出口 IP，请使用 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

完整的 Agent 参考文档（包括以编程方式购买访问权限）请参阅 https://atheris.ee/llms-full.txt。

许可证

MIT © Arvane Holdings OÜ