Dataify MCP CLI 常见问题

关于 Dataify MCP CLI 的通用问题、Token 配置、排错与配置相关的答疑。所有回答均基于本 CLI 的真实实现。

通用问题

Dataify MCP CLI 是什么？

它是一个跨平台的命令行工具，用来调用 Dataify MCP HTTP 服务暴露的数据采集工具（搜索、Web Unlocker、采集任务状态查询等）。它把 MCP 地址和工具列表固定下来，你只需配置 Token 并指定要调用的工具与参数。

需要什么运行环境？

Node.js：版本 >= 18.17（建议用 LTS 版本）。

操作系统：Windows、macOS、Linux 均可。

查看版本：node -v、npm -v。

有没有命令别名？

没有额外别名。全局安装后命令固定为 dataify，npx 运行时为 dataify-mcp-cli。

支持哪些输出形式？

默认：输出工具返回的主要内容——优先 structuredContent，否则提取文本类型 content；若文本能解析成 JSON 则美化输出。

--raw：输出完整的 MCP tool result（含 content、isError 等原始字段）。

--output <FILE>：把结果写入文件而不是打印到终端。

--pretty false：关闭 JSON 美化，输出单行紧凑内容。

支持哪些命令？

内置命令只有：tools / list、schema、call、直接以工具名调用 config、chat / repl（交互模式）、version、help。其余你输入的"命令"都会被当作工具名直接调用。

认证与 Token 配置

Token 在哪里配置？

有三种等价方式（按优先级覆盖）：

本地配置文件（推荐，最省事）：

单条命令内联：

环境变量（适合 CI / 容器）：

环境变量和配置文件，谁优先？

优先级从高到低：命令行选项 > 环境变量（DATAIFY_MCP_TOKEN / DATAIFY_API_TOKEN / DATAIFY_MCP_TIMEOUT） > 本地配置文件 > 内置默认值。所以命令行 --token 会覆盖环境变量，环境变量会覆盖配置文件。

怎么切换不同的 Token？

最简单的方式是重新设置：dataify config set --token NEW_TOKEN；或者只对某次调用使用不同 Token：dataify tools --token NEW_TOKEN。本工具通过 Token 鉴权，没有会话状态，重新设置 Token 即可切换账号。

Token 会不会泄露？

Token 会保存在本机用户目录的配置文件中，也会作为 MCP 请求 URL 的 token 查询参数发往 Dataify MCP 服务。因此：不要把 Token 提交到 Git 仓库，不要在公开日志中打印 Token。在共享环境用完后可删除配置文件（见下"如何重置配置"）。

排错

安装后提示找不到 `dataify` 命令

先关闭当前终端、重新打开后再试：

若仍找不到，检查 npm 全局安装目录是否在系统 PATH 中：

把该目录下的 bin 路径（例如 <prefix>/bin）加入 PATH 后重试。

`dataify tools` 没有返回任何工具

通常是 Token 不正确，或该 Token 没有对应工具的权限。请检查：

`schema` 查不到某个工具

先用 dataify tools 看当前 Token 实际能用的工具列表。如果该工具不在列表里，说明当前 Token 或 MCP 服务端没有返回它——schema 只能查服务端确实返回的工具，否则会报 Tool "<tool>" was not returned by the server。

调用 `google_search` 时返回失败或报错

google_search 属于实时采集类工具，返回结果可能受目标站点、代理、网络、采集队列等因素影响而失败或报错。可以尝试：

如需排查请求内容，加 --debug：

工具报参数类型错误 / 数字参数没生效

普通 --name value 一律按字符串发送。如果工具要求数字或布尔，务必用 --arg-json：

参数名里有连字符会怎样？

未知选项的连字符会被转换成下划线。例如 --no-cache true 会作为 no_cache 参数发送。如果参数本来就带下划线，直接写 --no_cache true 即可。

调用失败，如何看底层请求？

加 --debug，会把请求 URL 和 JSON-RPC 请求体打印到 stderr（不影响实际请求与结果）。若工具返回 isError，CLI 会以退出码 2 结束并把错误信息写到 stderr。

配置

配置文件保存在哪里？

~/.dataify-mcp-cli/config.json

可用 dataify config path 查看绝对路径。

MCP 地址和工具列表能改吗？

不能。MCP 地址固定为 https://mcp.dataify.com/mcp，tools 查询参数固定为内置的 25 个工具（包含 user_info、web_unlocker、google_serp、amazon、youtube、linkedin、github 等）。虽然解析器接受 --server / --endpoint / --tools，但运行时始终使用内置固定值，因此这些选项不会改变实际请求。你只需保证 Token 正确。

配置优先级是怎样的？

从高到低：命令行选项 > 环境变量 > 本地配置文件 > 内置默认值。每一项都可以按命令粒度覆盖上一项。

默认超时是多少？怎么改？

默认超时 120000 毫秒（120 秒）。修改方式（优先级同上）：

支持的格式：120000（毫秒）、30s（秒）、2m（分钟）。

如何重置所有配置？

删除配置文件即可，之后重新 dataify config set --token ...：

`config set` 能写哪些字段？

仅支持 token 与 timeout 两个字段。server 与 tools 是固定的，无法通过 set 修改（config get 会附带显示它们仅供确认）。

常见问题

Dataify MCP CLI 常见问题#

通用问题#

Dataify MCP CLI 是什么？#

需要什么运行环境？#

有没有命令别名？#

支持哪些输出形式？#

支持哪些命令？#

认证与 Token 配置#

Token 在哪里配置？#

环境变量和配置文件，谁优先？#

怎么切换不同的 Token？#

Token 会不会泄露？#

排错#

安装后提示找不到 dataify 命令#

dataify tools 没有返回任何工具#

schema 查不到某个工具#

调用 google_search 时返回失败或报错#

工具报参数类型错误 / 数字参数没生效#

参数名里有连字符会怎样？#

调用失败，如何看底层请求？#

配置#

配置文件保存在哪里？#

MCP 地址和工具列表能改吗？#

配置优先级是怎样的？#

默认超时是多少？怎么改？#

如何重置所有配置？#

config set 能写哪些字段？#