@dopplerhq/mcp-server

中文文档
1.0.5发布于 2026/06/05Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 1.5万

Doppler API 的 MCP 服务器, 使用 OpenAPI 规格自动生成的工具

中文使用文档
文档目录14 节
  1. 快速启动
  2. 用服务托肯
  3. 图标
  4. 选项
  5. 实例
  6. 隐性范围 探测
  7. 安保最佳做法
  8. 可用工具
  9. 无旗帜( 完全进入)
  10. 与 --read-only
  11. 与 --project
  12. 与 --config
  13. 发展
  14. 分支和发行流程

Doppler MCP 服务器

MCP(模式上下文协议)服务器,为AI助手提供访问多普勒API进行机密管理.

[大 多普勒MCP服务器是实验性的,用于开发,测试和评价目的. 因为输出是非决定性的,并且与连接的模型,查询和服务器配置不同,所以总是使用一个只针对您打算允许的行动,项目和环境的符号范围,并审查代理输出,以配合您的安全和合规要求.

快速启动

1. 认证:

npx @dopplerhq/mcp-server login

2. 添加到您的 MCP 客户端配置( 如 Claude 桌面) :

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["-y", "@dopplerhq/mcp-server"]
    }
  }
}

用服务托肯

或者,使用服务符号,而不是登录在:

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["-y", "@dopplerhq/mcp-server"],
      "env": {
        "DOPPLER_TOKEN": "<your-doppler-token>"
      }
    }
  }
}

见 服务 以创建配置范围符号.

图标

login              Authenticate with Doppler (interactive)
logout             Clear cached auth credentials

选项

--read-only        Only expose read operations (GET endpoints)
--project <name>   Override auto-detected project
--config <name>    Override auto-detected config
--verbose, -v      Enable verbose logging to stderr
-h, --help         Show help message

实例

只读模式

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["-y", "@dopplerhq/mcp-server", "--read-only"]
    }
  }
}

限于特定项目数字 :

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["-y", "@dopplerhq/mcp-server", "--project", "my-app"]
    }
  }
}

限于特定配置数字 :

{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": [
        "-y",
        "@dopplerhq/mcp-server",
        "--project",
        "my-app",
        "--config",
        "production"
      ]
    }
  }
}

隐性范围 探测

服务器会根据您的令牌访问权限自动检测范围 :

调试访问自动检测范围
单一项目--project 自动设定
单一项目 + 单一配置--project 财务报告和审定财务报表 --config 自动设定
多个项目不自动检测( 使用 CLI 旗)

这意味着 范围服务符号在框外工作 无任何 CLI 旗帜 :

{
  "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 用于深度防御:
{
  "mcpServers": {
    "doppler": {
      "command": "npx",
      "args": ["-y", "@dopplerhq/mcp-server", "--read-only"],
      "env": {
        "DOPPLER_TOKEN": "dp.st.readonly_token"
      }
    }
  }
}

说明: 服务器无法从符号中确定读/写权限, 因此如果您使用只读符号, 请添加 --read-only 只曝光读取的工具。 这阻止了写作工具出现在克洛德的工具列表中并避免了API呼叫失败.

可用工具

服务器自动生成工具 多普勒 OpenAPI 光谱。可用的工具取决于您的旗帜 :

无旗帜( 完全进入)

所有多普勒 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 参数是自动注入的.

发展

# 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 共发布 4 个版本,首次发布于 2025/10/29;过去 12 个月发布了 3 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.5latest2026/06/055 个月前
1.0.42026/02/258 个月前
1.0.32026/02/248 个月前
0.0.02025/10/291 年前

关于 @dopplerhq/mcp-server 的常见问题

@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 和提交记录判断。