# @dopplerhq/mcp-server 中文文档 规范地址：https://npmcn.com/package/%40dopplerhq/mcp-server/ 版本：1\.0\.5 npm 元数据更新时间：2026-06-04T20:10:57.780Z 中文译文更新时间：2026-11-12T16:36:54.616Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40dopplerhq/mcp-server 原文对照：https://npmcn.com/package/%40dopplerhq/mcp-server/?lang=original 项目主页：https://github.com/DopplerHQ/mcp-server#readme 源码仓库：https://github.com/DopplerHQ/mcp-server ## 关键信息（来自 npm 元数据） - 包体积（解压后）：487 kB，54 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - Node.js 要求：\>=20\.0\.0 - 运行依赖：3 个 - 首次发布：2025-10-28T18:52:17.874Z - 最新版本发布：2026-06-04T20:10:57.496Z - 近 30 天下载量：15256（2026-10-13 至 2026-11-11，npm 官方下载统计） - 已发布版本数：4（近 12 个月 3 个） ## 中文简介 Doppler API 的 MCP 服务器, 使用 OpenAPI 规格自动生成的工具 ## 安装 ```sh npm install @dopplerhq/mcp-server ``` 也可以使用：`pnpm add @dopplerhq/mcp-server`、`yarn add @dopplerhq/mcp-server`、`bun add @dopplerhq/mcp-server` ## README # Doppler MCP 服务器 MCP(模式上下文协议)服务器,为AI助手提供访问多普勒API进行机密管理. > \[大 多普勒MCP服务器是实验性的,用于开发,测试和评价目的. 因为输出是非决定性的,并且与连接的模型,查询和服务器配置不同,所以总是使用一个只针对您打算允许的行动,项目和环境的符号范围,并审查代理输出,以配合您的安全和合规要求. ## 快速启动 **1\. 认证:** ```bash npx @dopplerhq/mcp-server login ``` **2\. 添加到您的 MCP 客户端配置( 如 Claude 桌面) :** ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server"] } } } ``` ### 用服务托肯 或者,使用服务符号,而不是登录在: ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server"], "env": { "DOPPLER_TOKEN": "" } } } } ``` 见 [服务](https://docs.doppler.com/docs/service-tokens) 以创建配置范围符号. ## 图标 ``` login Authenticate with Doppler (interactive) logout Clear cached auth credentials ``` ## 选项 ``` --read-only Only expose read operations (GET endpoints) --project Override auto-detected project --config Override auto-detected config --verbose, -v Enable verbose logging to stderr -h, --help Show help message ``` ### 实例 **只读模式** ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server", "--read-only"] } } } ``` **限于特定项目**数字 : ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server", "--project", "my-app"] } } } ``` **限于特定配置**数字 : ```json { "mcpServers": { "doppler": { "command": "npx", "args": [ "-y", "@dopplerhq/mcp-server", "--project", "my-app", "--config", "production" ] } } } ``` ## 隐性范围 探测 服务器会根据您的令牌访问权限自动检测范围 : | 调试访问 | 自动检测范围 | | --- | --- | | 单一项目 | `--project` 自动设定 | | 单一项目 + 单一配置 | `--project` 财务报告和审定财务报表 `--config` 自动设定 | | 多个项目 | 不自动检测( 使用 CLI 旗) | 这意味着 **范围服务符号在框外工作** 无任何 CLI 旗帜 : ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server", "--read-only"], "env": { "DOPPLER_TOKEN": "dp.st.xxx" } } } } ``` CLI旗总是优先于自动检测到的值. ## 安保最佳做法 **使用范围化的服务标志,而不是CLI旗来进行访问控制.** 这个 `--project` 财务报告和审定财务报表 `--config` 旗帜提供了一个方便的UX层,但不能取代适当的符号范围界定。 总是以最小权限创建服务符 : 1. **具体项目的范围标志** 在多普勒仪表板中 2. **使用只读符号** 当不需要写入时 3. **将只读符号与 `--read-only`** 用于深度防御: ```json { "mcpServers": { "doppler": { "command": "npx", "args": ["-y", "@dopplerhq/mcp-server", "--read-only"], "env": { "DOPPLER_TOKEN": "dp.st.readonly_token" } } } } ``` 说明: 服务器无法从符号中确定读/写权限, 因此如果您使用只读符号, 请添加 `--read-only` 只曝光读取的工具。 这阻止了写作工具出现在克洛德的工具列表中并避免了API呼叫失败. ## 可用工具 服务器自动生成工具 [多普勒 OpenAPI 光谱](https://docs.doppler.com/reference/api)。可用的工具取决于您的旗帜 : ### 无旗帜( 完全进入) 所有多普勒 API 工具包括: - **工作场所**数字 : `workplace_get`, (中文(简体) ), `workplace_update` - **用户组( G)**数字 : `users_list`, (中文(简体) ), `groups_list`, (中文(简体) ), `service_accounts_list` - **项目**数字 : `projects_list`, (中文(简体) ), `projects_create`, (中文(简体) ), `projects_get`, (中文(简体) ), `projects_delete` - **环境**数字 : `environments_list`, (中文(简体) ), `environments_create`, (中文(简体) ), `environments_get` - **配置**数字 : `configs_list`, (中文(简体) ), `configs_create`, (中文(简体) ), `configs_get`, (中文(简体) ), `configs_update`, (中文(简体) ), `configs_lock` - **秘诀**数字 : `secrets_list`, (中文(简体) ), `secrets_get`, (中文(简体) ), `secrets_update`, (中文(简体) ), `secrets_download` - **一体化**数字 : `integrations_list`, (中文(简体) ), `syncs_list`, (中文(简体) ), `webhooks_list` ### 与 `--read-only` 只读工具(GET操作). 写操作像 `_create`, (中文(简体) ), `_update`, (中文(简体) ), `_delete` 没有暴露. ### 与 `--project` Org级工具被过滤出(`workplace_*`, (中文(简体) ), `activity_logs_*`) (中文(简体) ). 这个 `project` 参数被自动注入接受它的工具调用. ### 与 `--config` 只有配置和秘密管理工具 : - `configs_get`, (中文(简体) ), `configs_update`, (中文(简体) ), `configs_lock`, (中文(简体) ), `configs_unlock` - `secrets_list`, (中文(简体) ), `secrets_get`, (中文(简体) ), `secrets_update`, (中文(简体) ), `secrets_download` - `config_logs_list`, (中文(简体) ), `config_logs_rollback` 两者 `project` 财务报告和审定财务报表 `config` 参数是自动注入的. ## 发展 ```bash # Install dependencies pnpm install # Run tests pnpm test # Build pnpm run build # Run locally DOPPLER_TOKEN=dp.xxx pnpm start ``` ## 分支和发行流程 新的工作应当从主要和目标主要部分分入公关. 要发布,请按格式推动标签 `vX.X.X` 依语义发相. 这引发了建立和发布国家预防机制的出版工作流程. ## 常见问题 ### @dopplerhq/mcp-server 是什么？ Doppler API 的 MCP 服务器, 使用 OpenAPI 规格自动生成的工具 ### 如何安装 @dopplerhq/mcp-server？ 在项目目录运行 npm install @dopplerhq/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 doppler-mcp，可以用 npx doppler-mcp 直接运行。 ### @dopplerhq/mcp-server 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @dopplerhq/mcp-server 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @dopplerhq/mcp-server 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @dopplerhq/mcp-server 可以商用吗？ @dopplerhq/mcp-server 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。 ### @dopplerhq/mcp-server 的下载量有多少？ 根据 npm 官方下载统计，@dopplerhq/mcp-server 在 2026/10/13 – 2026/11/11 这 30 天内被下载 15,256 次，日均约 509 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @dopplerhq/mcp-server 还在维护吗？ 最新版本 1\.0\.5 发布于 2026/06/05（5 个月前）；至今共发布 4 个版本，其中过去 12 个月发布了 3 个；首次发布于 2025/10/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。