# @dreamworkhq/mcp 中文文档

规范地址：https://npmcn.com/package/%40dreamworkhq/mcp/

版本：1\.10\.0
npm 元数据更新时间：2026-11-05T22:59:49.601Z
中文译文更新时间：2026-11-12T23:14:50.006Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dreamworkhq/mcp
原文对照：https://npmcn.com/package/%40dreamworkhq/mcp/?lang=original
项目主页：https://www.dreamworkhq.com/agents
源码仓库：https://github.com/dreamworkhq/mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：511 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-05-26T04:58:17.957Z
- 最新版本发布：2026-11-05T22:59:49.173Z
- 近 30 天下载量：3245（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：24（近 12 个月 24 个）

## 中文简介

求职,应用材料,以及AI助手的应用跟踪.

## 安装

```sh
npm install @dreamworkhq/mcp
```

也可以使用：`pnpm add @dreamworkhq/mcp`、`yarn add @dreamworkhq/mcp`、`bun add @dreamworkhq/mcp`

## README

# @ 梦想workhq/ mcp

MCP 服务器 [梦想](https://www.dreamworkhq.com/?utm_source=github_readme&utm_medium=mcp_directory&utm_campaign=mcp_distribution):AI代理的求职工具. 任何MCP客户端(Claude Desktop, Cursor, MCP Victor)都可以使用它来寻找角色,排序,裁剪应用程序,申请,并跟踪一段时间内一个人的结果.

这个服务器是一个很薄的网关:它将Dreamwork API称为HTTPS之上,没有自己的数据库访问权限. 运输是Stdio,stdout只搭载了JSON-RPC帧.

## 安装

没有安装步骤 。 MCP客户端按要求运行 `npx`。以下示例 `npx -y @dreamworkhq/mcp`。 。 。 .

不需要启动密钥或账户。 无 `DREAMWORK_API_KEY` 服务器 在免费的宾客模式下运行,您的代理可以在此搜索并读取每个列表. 这个 `env` 下面的块是可选的; 想要账户时添加密钥 工具(见 [来宾模式和 API 密钥](https://npmcn.com/package/%40dreamworkhq/mcp/#readme-guest-mode-and-api-keys)) (中文(简体) ).

## 配置

### 克劳德桌面

添加条目到您的 `claude_desktop_config.json` (单位:千美元)`~/Library/Application Support/Claude/claude_desktop_config.json` 在macOS上:

```json
{
  "mcpServers": {
    "dreamwork": {
      "command": "npx",
      "args": ["-y", "@dreamworkhq/mcp"],
      "env": {
        "DREAMWORK_API_KEY": "sk_..."
      }
    }
  }
}
```

编辑后重新启动 Claude 桌面 。 把证书放进 `env` 块。 别 关闭 `command` 壳体或内装装置,例如: `dotenvx run -- …`: 在楼梯上 服务器中,任何用于显示包装打印的横幅都会损坏 JSON-RPC 流和 挂起工具调用.

### 光标和其他客户端

任何Stdio MCP客户端都有效. 光标使用上面显示的相同配置:指向 命令时 `npx -y @dreamworkhq/mcp` 通过 `DREAMWORK_API_KEY` 输入 环境。 与巡视员检查设置:

```bash
DREAMWORK_API_KEY=sk_... npx @modelcontextprotocol/inspector npx -y @dreamworkhq/mcp
```

### 主机端点

Dreamwork还服务于这些工具超流式的 HTTP `https://mcp.dreamworkhq.com/mcp`在克洛德.艾,克洛德桌面, 或ChatGPT, 添加该 URL 作为自定义连接符并签名到 Dreamwork 。 什么都没有 用于安装,没有粘贴键。 同意屏幕 询问哪个范围 连接器得到.

设置请求头的客户端可以向同一 URL 发送 API 密钥 换句话说 在克洛德代码中:

```bash
claude mcp add --transport http dreamwork https://mcp.dreamworkhq.com/mcp \
  --header "Authorization: Bearer sk_..."
```

## 来宾模式和 API 密钥

客座模式是免费的,不需要账户. 没有密钥集, 服务器开始于 来宾模式并曝光公众,只读工具 : `browse_listings`, (中文(简体) ), `get_listing`, (中文(简体) ), `get_platform_context`,以及 `get_upgrade_link`。服务器告诉 代理它以宾客模式进行,所以代理可以说出现在可行的. 账户 工具以一个简短的“无 API 密钥” 信息回答,该密钥列出了获取步骤.

主机端点的握手也一样. `initialize` 财务报告和审定财务报表 `tools/list` 这四个工具运行。 每个账户 工具,以及任何其他方法,答案 `401` 与 `WWW-Authenticate` 这样 连接器可以与 OAuth 签名 。 API拒绝的持枪人也是 `401`。 。 。 .

API 密钥需要免费账户 。 与您的简历、 已保存的工作相匹配, 定制材料、管道、招聘邮件和应用程序需要API钥匙. 任何Dreamwork账户都可以生成一个,包括免费计划. 你的计划 键的费率限制和使用津贴。 签名于 [dreamworkhq.com 互联网档案馆的存檔,存档日期2013-12-02](https://www.dreamworkhq.com/?utm_source=github_readme&utm_medium=mcp_directory&utm_campaign=mcp_distribution),打开配置文件,然后是 MCP(或使用) 在代理页面上获取密钥按钮,然后将密钥设定为 `DREAMWORK_API_KEY` (单位:千美元) `sk_...`)并重新启动您的 MCP 客户端.

当生成一个密钥时,您选择它可以做什么:读取、写出、应用、发送 邮件。 配置页从全部选中的4个开始; 取消选中您的任何内容 特工不应该这么做 钥匙能做的比你能做的少, 从来没有更多.

## 环境变量

| 变量 | 需求 | 默认 | 目的 |
| --- | --- | --- | --- |
| `DREAMWORK_API_KEY` | 账户工具 | 无 | API 密钥( E)`sk_...`) (中文(简体) ). 解锁管线,恢复,应用,拓展,剖析,采访. |
| `DREAMWORK_API_URL` | 没有 | `https://api.dreamworkhq.com` | 覆盖 API 端点( local dev /自主机) . |
| `DREAMWORK_UNREAD_NOTICES` | 没有 | 打开 | `off` (另见: `0`编号 :`false`编号 :`no`)停止工具运出未读收信员邮件的注释结果,并且不再让代理商在会话开始时检查邮件. 最多每5分钟检查一次;检查时从不标记邮件读取. |

`JOBLESS_API_TOKEN` 财务报告和审定财务报表 `JOBLESS_API_URL` 仍然被接受为落后兼容 别名用于 `DREAMWORK_API_KEY` 财务报告和审定财务报表 `DREAMWORK_API_URL`; 倾向于 `DREAMWORK_` 新配置的名称.

## 遥测

为了测量使用情况,服务器生成一个匿名随机安装 ID (a) UUID)在首次运行时将其存储在您的OS状态目录下 (单位:千美元)`$XDG_STATE_HOME/dreamwork/install-id`, (中文(简体) ), `~/.local/state/dreamwork/install-id` 打开 Linux/ macOS, 或者 `%LOCALAPPDATA%\dreamwork\install-id` )),在视窗上. 这是随机的 值,从未从您的主机名、用户名或任何机器属性中得出。 这个 计算唯一安装的来宾(未经认证)用途。 这是写在 运行时间在您的机器上, 从来没有在建设或发布时间.

通过设置任一环境变量来选择:

-   `DREAMWORK_TELEMETRY=0` (另见: `false`编号 :`no`编号 :`off`(中文(简体) )
-   `DO_NOT_TRACK=1` (单位:千美元) [标准](https://consoledonottrack.com/) 选择退出;并 `true`编号 :`yes`编号 :`on`(中文(简体) )

由于遥测功能被禁用,所以不会生成,读取或发送安装ID.

## 工具

典型流:浏览公共指数,将角色保存在管道上,裁缝 材料,应用,然后跟踪答复和访谈。 打电话 `get_platform_context` 先说 它描述了梦中工作可以做什么, 所以代理 选择正确的工作流程.

**公开( 无密钥 ) :**

`browse_listings`, (中文(简体) ), `get_listing`, (中文(简体) ), `get_market_pulse`, (中文(简体) ), `get_platform_context`, (中文(简体) ), `get_top_hiring_companies`, (中文(简体) ), `get_upgrade_link`

**助理动作 :** dreamwork的助理登记处每个能力有一个工具,每个工具都通过现场助理使用的同一授权梯子和收据分类账运行。 因此,它接了第一个电话,以一个摘要和一个确认书Token来回答;将同样的论点送回去.

`answer_application_questions`, (中文(简体) ), `apply`, (中文(简体) ), `cancel_apply`, (中文(简体) ), `confirm_hypothesis`, (中文(简体) ), `dismiss_application_questions`, (中文(简体) ), `dismiss_match`, (中文(简体) ), `edit_answer`, (中文(简体) ), `edit_cover_letter`, (中文(简体) ), `edit_resume`, (中文(简体) ), `forget_hypothesis`, (中文(简体) ), `format_resume`, (中文(简体) ), `generate_pack`, (中文(简体) ), `get_application_documents`, (中文(简体) ), `get_application_questions`, (中文(简体) ), `get_application_readiness`, (中文(简体) ), `get_application_status`, (中文(简体) ), `get_autopilot_settings`, (中文(简体) ), `get_autopilot_status`, (中文(简体) ), `get_career_record`, (中文(简体) ), `get_communication_preferences`, (中文(简体) ), `get_inbox`, (中文(简体) ), `get_job`, (中文(简体) ), `get_pack_status`, (中文(简体) ), `get_pipeline`, (中文(简体) ), `get_preferences`, (中文(简体) ), `get_resume_download_link`, (中文(简体) ), `get_resume_work_history`, (中文(简体) ), `get_task`, (中文(简体) ), `get_unread_reminders`, (中文(简体) ), `get_updates_since`, (中文(简体) ), `get_usage`, (中文(简体) ), `import_job`, (中文(简体) ), `list_dismissed_matches`, (中文(简体) ), `list_matches`, (中文(简体) ), `list_tasks`, (中文(简体) ), `mark_applied_offsite`, (中文(简体) ), `mark_messages_read`, (中文(简体) ), `move_pipeline`, (中文(简体) ), `parse_preferences_text`, (中文(简体) ), `prepare_applications`, (中文(简体) ), `remember_hypothesis`, (中文(简体) ), `replace_application_document`, (中文(简体) ), `reply_to_recruiter`, (中文(简体) ), `restore_match`, (中文(简体) ), `restore_material`, (中文(简体) ), `save_application_answers`, (中文(简体) ), `save_job`, (中文(简体) ), `set_autopilot`, (中文(简体) ), `start_checkout`, (中文(简体) ), `strengthen_application`, (中文(简体) ), `undo_last`, (中文(简体) ), `update_autopilot_settings`, (中文(简体) ), `update_communication_preferences`, (中文(简体) ), `update_preferences`

**直接产品工具:** 路径,后面没有登记动作.

`add_contact`, (中文(简体) ), `add_jobs`, (中文(简体) ), `generate_outreach`, (中文(简体) ), `generate_resume`, (中文(简体) ), `get_application_materials`, (中文(简体) ), `get_generated_resumes`, (中文(简体) ), `get_profile`, (中文(简体) ), `get_stats`, (中文(简体) ), `list_contacts`, (中文(简体) ), `list_interviews`, (中文(简体) ), `reopen_application_materials`, (中文(简体) ), `update_application_materials`, (中文(简体) ), `update_profile`, (中文(简体) ), `upload_resume`

服务器还提供5个提示,主机包括克洛德·桌面和 Claude 代码显示为命令 : `morning_brief` (自你上回以来有什么变化) 请检查, `find_and_prepare` (搜索、取取、准备材料), `apply_to_prepared` (填写任何缺失的答案,复议,应用 确认, `interview_prep`,以及 `autopilot_setup`。 。 。 .

关于一些工具的说明:

-   没有工具在第一次通话时发送邮件或提交应用程序 . `apply`, (中文(简体) ), `reply_to_recruiter`, (中文(简体) ), `set_autopilot`, (中文(简体) ), `update_autopilot_settings` 财务报告和审定财务报表 `start_checkout` 返回时 `held` 附有摘要和 `confirmationToken`,以及 只有当您将同样的参数发回时,才会采取行动.
-   1.3.0 移除登记册行动取代的1.2.0工具: `search_jobs` 财务报告和审定财务报表 `list_applications` (使用时 `get_pipeline`· ; `browse_listings` 搜索该 指数, `apply_to_job` (单位:千美元)`apply`, (中文(简体) ), `add_listing_to_pipeline` (单位:千美元)`save_job`, (中文(简体) ), `skip_job` (单位:千美元)`dismiss_match`),以及 `send_outreach`答复和重新提交 通过 `reply_to_recruiter` 财务报告和审定财务报表 `apply`。 。 。 .
-   1.5.1之后的释放不再包括 `list_escalations` 财务报告和审定财务报表 `resolve_escalation`,而托管服务器不再提供它们。 梦想 不再把一个申请交给你 作为升级,所以有 没有他们可以列出或解决的.
-   `update_application_materials` 财务报告和审定财务报表 `reopen_application_materials` 打开 应用推出组群 API 所承认 API自己拒绝.
-   `get_stats` 汇总报名候选人自己的管道,所以需要 和其余的一样.

### 关键范围

API 密钥带有范围, 当生成时选择 :

| 范围 | 解锁的东西 |
| --- | --- |
| `read` | 每个读取动作:匹配、管道、收件箱、状态、使用、收据 |
| `write` | 便宜和排队的写法:保存、删除、移动、编辑材料、首选、退出链接 |
| `apply` | 提交应用程序, 取消仍在发送的应用程序和自动驾驶 |
| `send` | 邮寄招聘人员 |

瞄准镜打开了行动的每一条道路,包括直接路线. `write` 是修改任何东西的会场: 任何键上没有它就会被拒绝 请求不是 `GET`, (中文(简体) ), `HEAD`,或 `OPTIONS`,因此读取的密钥不能重写 通过直接拨打路由来配置或移动棋盘。 没有键 `apply` 被拒绝时 `apply`时 `POST /jobs/:id/apply`涡轮跑道和升级道 键 无 `send` 被拒绝时 `reply_to_recruiter`时 `POST /outreach/send` 时间 `POST /conversations/:id/reply`直接通话 回答 403 与 `api_key_scope_required`范围,它想要, 和一条信息 说该怎么做; 助理动作解答 `action_not_authorized` 与同样的下一步.

一个密钥永远不能管理密钥,旋转会话符号,或者删除账户. 这些答复403 `session_required` 随其所持.

配置文件页预选了全部四个范围, 以及一个未命名的密钥请求 瞄准镜会读会写 瞄准镜存在前创建的密钥保留它的一切 已经可以了.

## 解决问题

-   **工具呼叫悬/超时,但握手成功.** 有一点 将非 JSON- RPC 字节写入 stdout 。 确保 `command` 没有包裹在一个 打印横幅的嵌入器或外壳, 并更新到最新版本 (单位:千美元)`npx -y @dreamworkhq/mcp@latest`; 清除 npx 缓存 `rm -rf ~/.npm/_npx` 如果旧建筑被缓存的话。 stdout只必须携带协议框架. 所有服务器 伐木去斯德尔.
-   **每个账户工具都说"没有API密钥".** `DREAMWORK_API_KEY` 没有 进入进程。 证实在 `env` 块中的客户端配置.
-   **每个账户工具都说"API密钥被拒绝".** 密钥传到服务器上, 但它已经过期或被撤销。 在Profile下创建一个新的,然后是MCP, 替换 `DREAMWORK_API_KEY` 并重新启动您的 MCP 客户端.
-   **应用返回 `missing_onboarding_fields` 或者说 `missing_profile_fields`。 。 。 .** 工具报告缺失的字段和修复每个字段的 Dreamwork 路径 一个 重试前在 Dreamwork 中完成这些细节; 失败的请求 未启动应用程序.

## 发展

```bash
pnpm --filter @dreamworkhq/mcp check   # typecheck
pnpm --filter @dreamworkhq/mcp build   # emit dist/
pnpm --filter @dreamworkhq/mcp test    # unit tests
```

标准入口是 [`src/stdio.ts`](https://npmcn.com/package/%40dreamworkhq/mcp/src/stdio.ts); 工具定义为 [`src/mcp.ts`](https://npmcn.com/package/%40dreamworkhq/mcp/src/mcp.ts); HTTP API 客户端是 [`src/client.ts`](https://npmcn.com/package/%40dreamworkhq/mcp/src/client.ts)。 。 。 .

服务器只从进程环境读取配置 。 没有 装入 a `.env` 文档。 对于本地开发,输出您外壳中的 vars( 如. `DREAMWORK_API_URL=http://127.0.0.1:3000 pnpm --filter @dreamworkhq/mcp stdio`) (中文(简体) ).

一揽子边界决定、工具登记公约 (单位:千美元)`registerDreamworkTool`),出错/版本规则,以及被推迟的审查触发器 记录在 [`ARCHITECTURE.md`](https://npmcn.com/package/%40dreamworkhq/mcp/ARCHITECTURE.md)。上面的工具目录是 与注册工具的漂移核对 `test/tool-catalog.test.ts`。 。 。 .

## 许可证

麻省理工学院

## 常见问题

### @dreamworkhq/mcp 是什么？

求职,应用材料,以及AI助手的应用跟踪\.

### 如何安装 @dreamworkhq/mcp？

在项目目录运行 npm install @dreamworkhq/mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dreamwork-mcp，可以用 npx dreamwork-mcp 直接运行。

### @dreamworkhq/mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dreamworkhq\_\_mcp 是否存在。

### @dreamworkhq/mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @dreamworkhq/mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dreamworkhq/mcp 可以商用吗？

@dreamworkhq/mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dreamworkhq/mcp 的下载量有多少？

根据 npm 官方下载统计，@dreamworkhq/mcp 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,245 次，日均约 108 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dreamworkhq/mcp 还在维护吗？

最新版本 1\.10\.0 发布于 2026/11/06（7 天前）；至今共发布 24 个版本，其中过去 12 个月发布了 24 个；首次发布于 2026/05/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。