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