MCP

🚀 OpenFeature MCP

OpenFeature 是一個開放規範，它提供了一個與供應商無關、由社區驅動的特性開關 API，可與你喜歡的特性開關管理工具或內部解決方案配合使用。OpenFeature MCP 則進一步增強了這一能力，為 AI 編碼助手與 OpenFeature 之間搭建了標準化的交互橋樑。

🚀 快速開始

NPX 安裝

使用 OpenFeature MCP 服務器最簡單的方法是通過 NPX，無需安裝：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}

NPM 全局安裝

你也可以全局安裝 MCP 服務器：

npm install -g @openfeature/mcp

然後配置你的 AI 助手使用全局安裝：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "openfeature-mcp"
    }
  }
}

✨ 主要特性

連接 AI 編碼助手與 OpenFeature

OpenFeature 模型上下文協議（MCP）服務器使 AI 編碼助手能夠通過標準化協議與 OpenFeature 進行交互。它作為本地工具，將 AI 編碼助手（如 Cursor、Claude Code、VS Code 和 Windsurf）連接到 OpenFeature 功能，充當 AI 助手與 OpenFeature 能力之間的橋樑，實現智能代碼生成和遷移、SDK 安裝指導以及特性開關評估。

提供實用工具

• SDK 安裝指南（install_openfeature_sdk）：可獲取各種語言和框架的 OpenFeature SDK 安裝說明，還可選擇包含特定供應商的設置文檔。
• OFREP 標誌評估（ofrep_flag_eval）：使用 OpenFeature 遠程評估協議（OFREP）評估特性開關，支持單開關和批量評估。

📦 安裝指南

Cursor

📦 在 Cursor 中安裝 點擊上述安裝按鈕，可打開 Cursor 並自動添加 OpenFeature MCP。 或者，導航到 Cursor 設置 -> 工具與 MCP -> 新 MCP 服務器，並添加到 ~/.cursor/mcp_settings.json：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}

VS Code

📦 在 VS Code 中安裝 點擊上述安裝按鈕，可打開 VS Code 並自動添加 OpenFeature MCP。 或者，添加到 .continue/config.json：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}

Claude Code

通過 Claude Code CLI 添加服務器：

claude mcp add --transport stdio openfeature npx -y @openfeature/mcp

然後在 CLI 中使用 /mcp 管理連接。

Windsurf

在 管理 MCP 服務器 原始配置中添加：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}

Codex CLI

編輯 ~/.codex/config.toml：

[mcp_servers.openfeature]
command = "npx"
args = ["-y", "@openfeature/mcp"]

保存後重啟 Codex CLI。

Gemini CLI

編輯 ~/.gemini/settings.json：

{
  "mcpServers": {
    "OpenFeature": {
      "command": "npx",
      "args": ["-y", "@openfeature/mcp"]
    }
  }
}

保存後重啟 Gemini CLI。

Claude Desktop

編輯 Claude Desktop 配置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json 添加以下配置：

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

保存後重啟 Claude Desktop。

💻 使用示例

SDK 安裝示例

"為 Node.js 安裝帶有 flagd 供應商的 OpenFeature SDK" AI 將使用 MCP 獲取相關安裝說明，並嘗試使用正確的供應商安裝 OpenFeature SDK。

標誌評估示例

當與你的 AI 助手交互時：

"你能檢查 'user-123' 的 'new-checkout-flow' 特性開關的值嗎？" AI 將使用 MCP 通過 OFREP 評估開關，併為你提供結果，以及變體和原因等額外元數據。

🔧 技術細節

SDK 安裝指南工具參數

支持的技術

支持的供應商

供應商列表自動從 OpenFeature 生態系統（open-feature/openfeature.dev 倉庫）獲取。有關如何維護供應商列表的詳細信息，請參閱 scripts/build-providers.js。

OFREP 標誌評估工具參數

OFREP 配置

要使用 OFREP 標誌評估功能，請配置身份驗證和端點詳細信息。服務器按以下優先級順序檢查配置：

1. 環境變量
   • OPENFEATURE_OFREP_BASE_URL 或 OFREP_BASE_URL
   • OPENFEATURE_OFREP_BEARER_TOKEN 或 OFREP_BEARER_TOKEN
   • OPENFEATURE_OFREP_API_KEY 或 OFREP_API_KEY
2. 配置文件：~/.openfeature-mcp.json

示例 ~/.openfeature-mcp.json：

{
  "OFREP": {
    "baseUrl": "https://flags.example.com",
    "bearerToken": "<your-token>",
    "apiKey": "<your-api-key>"
  }
}

你可以使用 OPENFEATURE_MCP_CONFIG_PATH 環境變量覆蓋配置文件路徑。

⚠️ 重要提示

本項目正在積極開發中，功能和 API 可能會發生變化。

⚠️ 重要提示

AI 代理是非確定性的，可能無法正確完成任務。在提交更改之前，請始終手動審核。如果你遇到問題，請 打開一個問題，詳細說明你的 AI 代理（例如，Claude Code + Sonnet 4.5，Cursor + gpt-5-codex）、你使用的命令以及你看到的行為。

📚 詳細文檔

資源

• NPM 包：@openfeature/mcp
• MCP 註冊表：dev.openfeature/mcp
• OpenFeature 文檔：openfeature.dev
• CNCF Slack：加入 #openfeature

參與貢獻

OpenFeature MCP 服務器是由 OpenFeature 社區維護的開源項目。我們歡迎貢獻：

• 報告問題：GitHub 問題
• 貢獻代碼：貢獻指南
• 建議功能：在 CNCF Slack 的 #openfeature 頻道分享想法
• 改進文檔：幫助我們改進 SDK 安裝指南和示例 加入 CNCF Slack 參與其中。