LaunchDarkly's Model Context Protocol (MCP) Server

LaunchDarkly 本地 MCP 服务

适用于 LaunchDarkly 联邦和欧盟（EU）环境的本地 Model Context Protocol（MCP） 服务。

重要

在可用时，请使用 LaunchDarkly 托管 MCP 服务

LaunchDarkly 强烈建议在可用时使用托管 MCP 服务。与此自管理服务相比，托管服务的功能更完善，更新也更频繁。

LaunchDarkly 为 LaunchDarkly EU 或 Federal 实例提供此自管理 MCP 服务，因为这些实例目前尚不支持托管 MCP。

目录

• LaunchDarkly 本地 MCP 服务
  • 安装
  • 要求
  • 可用资源和操作
  • 可用环境
  • 贡献
  • 关于 LaunchDarkly

安装

此 MCP 服务可安装在任何支持 MCP 协议的 AI 客户端中。如果这里未列出，请参阅你的 AI 客户端说明。

运行时要求

重要

2026 年 10 月，部分 eMudhra 中间证书颁发机构遭到入侵（公告）。网络中任何持有其密钥的人都可能拦截服务器与 LaunchDarkly 的连接，并读取你的 API 访问令牌。

• **npx 和本地安装：**使用 Node.js 22.23.4、24.22.1、26.12.1 或更高版本。这些版本会拒绝遭入侵的中间证书。服务也会自行拒绝这些证书，并在运行时不符合要求时于启动时显示警告。
• **Docker：**使用 0.7.1 或更高版本的映像。这些映像运行于 Node.js 24.22.1；0.7.0 及更早版本运行于 Node.js 24.2.0。
• **独立二进制文件：**停止使用 v0.6.1 及更早版本发行版附带的 mcp-server-bun-* 二进制文件。这些文件内置的 Bun 运行时不会拒绝遭入侵的中间证书，并且已不再发布。请改用搭配已修补 Node.js 的 npx，或使用 Docker。

Cursor 安装步骤

在项目根目录中创建 .cursor/mcp.json 文件，内容如下：

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

指定 LaunchDarkly Authorization 页面上显示的 API 密钥。

Claude 安装步骤

将以下服务定义添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

指定 LaunchDarkly Authorization 页面上显示的 API 密钥。

Qodo Gen 安装步骤

1. 在 VSCode 或 IntelliJ 中打开 Qodo Gen 聊天面板。
2. 点击 Connect more tools。
3. 点击 + Add new MCP。
4. 添加以下配置：

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

指定 LaunchDarkly Authorization 页面上显示的 API 密钥。

5. 点击 Save。

GitHub Copilot CLI 安装步骤

使用 Copilot CLI 交互式添加 MCP 服务：

/mcp add

或者创建/编辑 ~/.copilot/mcp-config.json，内容如下：

{
  "mcpServers": {
    "LaunchDarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

指定 LaunchDarkly Authorization 页面上显示的 API 密钥。

更多信息请参阅 GitHub Copilot CLI 文档。

从本地克隆安装

你也可以克隆此代码库，在本地运行 MCP 服务。克隆后，需要安装依赖项（npm install）并构建服务（npm run build）。

然后，配置服务定义以引用你的本地克隆。例如：

{
  "mcpServers": {
    "launchdarkly": {
      "command": "node",
      "args": [
        "/path/to/mcp-server/bin/mcp-server.js", "start",
        "--api-key", "api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      ]
    }
  }
}

使用环境变量的安装步骤

某些 AI 客户端允许在 MCP 配置中访问环境变量。在支持此功能的 AI 客户端中，你可以按如下方式配置 MCP 服务，使其从 MCP_LD_TOKEN 等环境变量读取值：

{
  "mcpServers": {
    "launchdarkly": {
      "command": "npx",
      "args": [
        "-y", "--package", "@launchdarkly/mcp-server", "--", "mcp", "start",
        "--api-key", "$LD_ACCESS_TOKEN"
      ],
      "env": {
        "LD_ACCESS_TOKEN": "MCP_LD_TOKEN"
      }
    }
  }
}

Docker 安装步骤

如果从 AWS Markeplace 安装 MCP 服务，请按照 Marketplace 列表中提供的说明，使用经过身份验证的角色拉取镜像。

运行容器：

docker run --rm -p 127.0.0.1:8080:8080 709825985650.dkr.ecr.us-east-1.amazonaws.com/launchdarkly/mcp --api-key api-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --auth-token "$MCP_AUTH_TOKEN"

容器监听 0.0.0.0，因此必须提供 --auth-token（至少 16 个字符）。客户端必须在 /sse 和 /message 上发送 Authorization: Bearer <token>。在 Docker 外部，SSE 传输默认监听 127.0.0.1；传入 --host 可更改监听地址，若使用非环回主机地址，则还必须提供 --auth-token。

然后，将服务器定义配置为指向正在运行的容器。例如：

{
  "mcpServers": {
    "launchdarkly": {
      "url": "http://localhost:8080/sse",
      "headers": {
        "Authorization": "Bearer <your --auth-token value>"
      }
    }
  }
}

这在不支持直接在 MCP 配置中访问环境变量的 AI 客户端（如 Cursor）中无法使用。解决方法是从 MCP 配置中调用本地脚本。示例请参见此处。

要求

有关支持的 JavaScript 运行时，请参阅 RUNTIMES.md。

可用资源和操作

可用方法

AiConfigs

• getTargeting - 显示 AI Config 的定位设置
• updateTargeting - 更新 AI Config 的定位设置
• list - 列出 AI Config
• create - 创建新的 AI Config
• delete - 删除 AI Config
• get - 获取 AI Config
• update - 更新 AI Config
• createVariation - 创建 AI Config 变体
• deleteVariation - 删除 AI Config 变体
• getVariation - 获取 AI Config 变体
• updateVariation - 更新 AI Config 变体

AuditLog

• listEntries - 列出审计日志条目

CodeReferences

• listRepositories - 列出代码库

Environments

• listByProject - 列出环境

Experiments

• list - 获取实验
• create - 创建实验
• get - 获取实验
• patch - 更新实验
• createIteration - 创建迭代 :warning: 已弃用
• getExperimentsAnyEnv - 获取任意环境中的实验

FeatureFlags

• getStatus - 获取各环境中的标志状态
• list - 列出功能标志
• create - 创建功能标志
• get - 获取功能标志
• patch - 更新功能标志
• delete - 删除功能标志

指标

• list - 列出指标
• create - 创建指标
• get - 获取指标
• patch - 更新指标

可用环境

大多数客户账户运行在 LaunchDarkly 的商业（默认）环境中。使用其他环境的客户可以指定 --server-url 参数，以连接到相应的环境。例如，使用 LaunchDarkly 联邦环境的客户在启动 MCP 服务时，应指定 --server-url https://app.launchdarkly.us 参数。

环境	服务 URL
商业（默认）	https://app.launchdarkly.com
联邦	https://app.launchdarkly.us
欧盟	https://app.eu.launchdarkly.com

贡献

我们重视对这个 SDK 的开源贡献，但这个库是通过程序生成的。对内部文件所做的任何手动更改都会在下次生成时被覆盖。 我们期待听到你的反馈。欢迎提交 PR 或 issue，并附上概念验证；我们会尽力在未来的版本中纳入。

关于 LaunchDarkly

• LaunchDarkly 是一个持续交付平台，以服务形式提供功能标志，让开发者能够快速、安全地迭代。你可以轻松地为功能启用标志，并通过 LaunchDarkly 控制面板进行管理。借助 LaunchDarkly，你可以：
  • 向部分用户推出新功能（例如，向选择加入 Beta 测试组的用户推出），并从真实使用场景中收集反馈和错误报告。
  • 逐步向越来越多的用户推出某项功能，并跟踪该功能对关键指标的影响（例如，启用功能 A 的用户与启用功能 B 的用户相比，完成购买的可能性有何不同？）。
  • 如果发现某项功能导致生产环境出现性能问题，无需重新部署，甚至无需通过更改配置文件来重启应用，即可关闭该功能。
  • 根据用户属性（例如付费方案）授予用户访问特定功能的权限（例如，使用“gold”方案的用户比使用“silver”方案的用户可以访问更多功能）。
  • 禁用应用的部分功能以便进行维护，而无需让整个应用下线。
• LaunchDarkly 为多种语言和技术提供功能标志 SDK。阅读我们的文档，查看完整列表。
• 探索 LaunchDarkly
  • 注册免费的 LaunchDarkly 账户
  • 访问 launchdarkly.com 了解更多信息
  • 访问 launchdarkly.com/docs 查看我们的文档和 SDK 参考指南
  • 访问 launchdarkly.com/docs/api 查看我们的 API 文档
  • 访问 blog.launchdarkly.com 获取最新产品更新