NodeMaven

io.github.nodemavenv0.1.0更新於 Oct 6, 2026

NodeMaven residential proxies: geo-targeted proxy URLs, sticky sessions, checks and usage

已驗證STDIO僅桌面Cloud & InfrastructureWeb Search & Scraping

概覽

AI 產生的概覽

讓助理產生帶地理定位的 NodeMaven 住宅代理網址、測試代理連線，並讀取帳戶流量用量。

功能
封裝 NodeMaven 住宅代理服務。工具可依國家、地區、城市或 ISP 產生代理字串，支援黏性工作階段以及 HTTP 或 SOCKS5；可開啟一次測試連線並回傳狀態、出口 IP 與耗時；可列出可定位的地點；還可讀取帳戶狀態、流量統計、流量最高的網域以及子使用者用量。此服務為唯讀：不會在帳戶中建立、變更或刪除任何內容。
適用情境
當助理需要為指定地點建立或驗證住宅代理連線，或在不開啟 NodeMaven 儀表板的情況下回報代理流量與用量時適用。
執行需求
透過 stdio 在本機執行，通常使用 uvx 或 pip 安裝 nodemaven-mcp 套件，因此需要 Python 以及 Claude Desktop、Cursor 等 MCP 用戶端。必須在 NODEMAVEN_APIKEY 環境變數中提供 NodeMaven API 金鑰；選用的 NODEMAVEN_LOGIN 與 NODEMAVEN_PASSWORD 可提供其他代理憑證。需要能連線至 NodeMaven 的網路。
安裝前請注意
NODEMAVEN_APIKEY 中的 API 金鑰可存取帳戶及其代理憑證。工具結果會進入模型上下文與聊天記錄，因此除非設定 NODEMAVEN_MCP_REVEAL_PASSWORD=1，伺服器會把代理密碼顯示為佔位符；該變數會暴露真實密碼，非必要不要開啟。代理流量會從帳戶剩餘流量中扣減。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 NodeMaven，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

nodemaven-mcp

An MCP server for NodeMaven residential proxies. It lets an AI assistant build proxy strings with geo-targeting and sticky sessions, check that a proxy connects and where it exits, look up locations, and read traffic usage.

It is read-only: nothing in your account is created, changed or deleted.

Tools

ToolWhat it does
proxy_urlProxy string for a country, region, city or ISP, with an optional sticky session and its lifetime. HTTP or SOCKS5.
check_proxyOpens one connection through the proxy and returns the status, the exit IP and the time it took.
list_locationsCountries, regions, cities and ISPs available for targeting, with the codes proxy_url takes.
account_statusRemaining traffic, subscription status, whether traffic is frozen.
traffic_statsTraffic used over time.
top_domainsDomains reached through the proxy, with traffic per domain.
list_sub_usersSub-users with their usage and limits.

Setup

You need an API key from the NodeMaven dashboard. The proxy username and password are read from the account through that key, so nothing else is required.

Claude Desktop (claude_desktop_config.json), Cursor and other MCP clients:

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

Without uv: pip install nodemaven-mcp and use "command": "nodemaven-mcp".

Variable
NODEMAVEN_APIKEYRequired.
NODEMAVEN_LOGIN, NODEMAVEN_PASSWORDOptional. Proxy credentials to use instead of the account's own, e.g. a sub-user.
NODEMAVEN_MCP_REVEAL_PASSWORD1 puts the real password into proxy_url output. Off by default.

Credentials

Tool results go into the model's context and usually into the chat history, so the server keeps secrets out of them:

  • proxy_url returns the password as <PROXY_PASSWORD> unless NODEMAVEN_MCP_REVEAL_PASSWORD=1 is set.
  • API responses are reduced to a fixed list of fields; proxy passwords and the account email are never returned.

Development

bash
uv syncuv run pytest

Built on the nodemaven Python SDK.

License

MIT

來源：README.md，提交 9ac70d5

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 6, 2026