Nullprint

国内 AI 接入教程

不需要境外账号,用 TRAE CN 或 Cherry Studio + DeepSeek,十分钟让国产 AI 帮你建身份、开浏览器、操作网页。海外用户用 Claude Code / Codex 请看海外 AI 接入教程;完整工具说明见 MCP 文档。

用哪个 AI

要连 Nullprint,AI 必须是装在电脑上的客户端,并且支持本地(STDIO)MCP。网页版的豆包、Kimi、DeepSeek 对话页都连不了你电脑上的程序。国内用起来最顺的两个:

方案是什么费用适合谁
A. TRAE CN(推荐)字节跳动出品的 AI 客户端,手机号登录,内置豆包、DeepSeek 等国产模型,自带「Builder with MCP」智能体免费想最快上手、不想申请 API Key
B. Cherry Studio + DeepSeek开源 AI 聊天客户端,界面像普通聊天软件;模型用 DeepSeek 官方 API软件免费;DeepSeek 按用量付费习惯聊天界面、想自己选模型

通义灵码、腾讯 CodeBuddy、Kimi CLI 等支持 mcpServers 配置的工具也能用下文同一段配置接入。

准备

1. 装好 Nullprint 并保持运行

  1. 从下载页安装 Nullprint(Windows / macOS),打开并登录。
  2. 用 AI 期间 Nullprint 要一直开着(可以最小化)。端口和密钥会自动读取,不用手动填。

2. 装 Node.js(方案 A 需要)

  1. 到 nodejs.org 下载 LTS 版安装包(国内慢可用镜像 npmmirror.com/mirrors/node),一路「下一步」。
  2. 验证:Windows 按 Win+R 输入 cmd 回车,Mac 打开「终端」,输入 node -v,显示 v20 或更高即可。
  3. 装完后,已经开着的 TRAE 要完全退出再打开,否则找不到 npx。
方案 B 不用自己装 Node.js 或 Python,Cherry Studio 里可以一键安装运行环境。

方案 A:TRAE CN

1. 下载与登录

  1. 打开 trae.cn,下载对应系统的安装包并安装。
  2. 首次打开按提示用手机号 + 短信验证码登录,不需要 API Key。

2. 添加 Nullprint MCP

  1. 右上角 设置(齿轮) → 左侧 MCP。
  2. 点 添加 → 手动添加(第一次添加时页面中间就有「手动添加」)。
  3. 清空输入框,粘贴下面这段,点 确认:
{
  "mcpServers": {
    "nullprint": {
      "command": "npx",
      "args": ["-y", "nullprint-mcp"],
      "env": {
        "npm_config_registry": "https://registry.npmmirror.com"
      }
    }
  }
}

env 让下载走国内 npm 镜像,更快;海外网络可以删掉这三行。

  1. 等几秒到一分钟(第一次会自动下载),nullprint 后面出现绿色对勾、展开能看到 17 个工具,就是连上了。

3. 在对话里使用

  1. 打开 AI 对话面板,在输入框输入 @,选择智能体 Builder with MCP(自动带上所有已添加的 MCP 工具)。也可以新建自己的智能体,在「工具 → MCP」里只勾 nullprint。
  2. 模型选豆包、DeepSeek 等都可以。
  3. 输入 列出我 Nullprint 里所有的浏览器身份。第一次调用工具时会弹出确认,点 运行 / 允许,看到身份列表即成功。

方案 B:Cherry Studio + DeepSeek

1. 注册 DeepSeek 开放平台,拿 API Key

  1. 打开 platform.deepseek.com(不是聊天页 chat.deepseek.com),用手机号注册登录。
  2. 按提示完成实名认证,未实名无法创建 API Key。
  3. 左侧 充值,支持支付宝 / 微信,先充 10 元足够试用很久。
  4. 左侧 API Keys → 创建 API Key。sk- 开头的密钥只显示这一次,立刻复制保存,不要发给别人。

2. 安装 Cherry Studio,接入 DeepSeek

  1. 从 cherry-ai.com 下载安装 Cherry Studio。
  2. 左下角 设置 → 模型服务 → 深度求索,粘贴 API Key,点「检查」成功后打开启用开关。
  3. 确认模型列表里有 DeepSeek 对话模型(如 deepseek-chat)。MCP 要求模型支持「函数调用 / 工具」,DeepSeek 对话模型是支持的。

3. 添加 Nullprint MCP

  1. 设置 → MCP 服务器。如果提示缺少 uv 或 bun,点提示里的 安装,等它装完。
  2. 点 添加服务器,按下表填写,保存后打开这个服务器的启用开关:
字段填写
名称nullprint
类型标准输入/输出(STDIO)
命令uvx
参数nullprint-mcp
环境变量UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple(清华镜像,下载更快;海外可不填)

习惯 JSON 的话,在 MCP 服务器页点「编辑 JSON」,在 mcpServers 里加入:

"nullprint": {
  "command": "uvx",
  "args": ["nullprint-mcp"],
  "env": { "UV_INDEX_URL": "https://pypi.tuna.tsinghua.edu.cn/simple" }
}

第一次会自动下载,点进服务器在「工具」页看到 17 个工具即成功。

4. 在对话里使用

  1. 新建对话,顶部模型选 DeepSeek。
  2. 点输入框下方的 MCP 图标,勾选 nullprint。每个新对话都要勾一次,不勾 AI 就看不到这些工具。
  3. 输入 列出我 Nullprint 里所有的浏览器身份,回复里出现工具调用记录和身份列表即成功。

怎么跟 AI 说

你这样说AI 会做什么
列出我所有的浏览器身份显示每个身份的名字、是否在运行、出口信息
新建一个身份叫 shop-01,代理 socks5://用户名:密码@IP:端口建身份,指纹自动生成并固定
先测一下这个代理能不能用测出口 IP、国家、延迟
打开 shop-01,进 example.com启动浏览器窗口并跳转
把搜索框填上「耳机」再回车读页面结构,填写、点击、按键
shop-01 开了几个标签页?切到第二个列出并切换标签页
给 shop-01 做个体检一致性检查,列出有问题的项
关掉 shop-01关闭该身份的浏览器
把 shop-01 删了 / 回收站里有什么 / 恢复它移入回收站(可恢复)、查看、恢复
说清楚身份名字(区分大小写),一步一步交代比一次说一长串更稳。需要登录的网站,先让 AI 打开页面,账号密码和验证码自己在窗口里输,登好之后再让 AI 接着做。

常见问题

AI 说 Nullprint 没在运行 / 连不上 daemon。 打开 Nullprint 并登录,保持开着再试。

TRAE 里 nullprint 红色报错、找不到 npx。 装 Node.js,然后完全退出 TRAE 再打开。

Cherry Studio 报 uvx 找不到。 设置 → MCP 服务器,点「安装 uv」,装完重开 Cherry Studio。

第一次添加卡很久。 首次要下载程序包,确认配置里填了国内镜像。

AI 只聊天、不调用工具。 TRAE:确认用的是 @Builder with MCP 或勾了 nullprint 的智能体;Cherry:确认本对话勾了 nullprint,模型支持工具调用。

AI 说身份不存在。 先让它「列出所有身份」,用列表里的准确名字。

AI 说要先打开会话。 页面操作需要身份已经打开,先说「打开 xxx」。

安全提醒

  • AI 操作的是你已登录的浏览器身份,等于把账号交给它用。付款、改密、删除类操作请自己确认。
  • 用完说一句「关掉 xxx」,不要让浏览器长时间挂在 AI 手里。
  • 彻底删除(清空回收站)不开放给 AI,只能你在客户端里操作。
  • nullprint-mcp 只在你电脑上运行、只连本机 Nullprint,不往我们服务器发数据;但你和 AI 的对话会发给你选的模型厂商。
  • DeepSeek 的 API Key 等于你的余额,泄露了到开放平台删除重建。