DevCycle MCPサーバー
コミット 2026年11月9日AIコーディングアシスタントが、エディタからDevCycleのフィーチャーフラグ、変数、バリエーション、およびターゲティングルールを作成、更新、管理できるようにします。
別名 DevCycleHQ/cli, cli
- スター
- 20
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 6.6.1
- 最終コミット
- 2026年11月9日
- ライセンス
- MIT
DevCycle MCPとは
DevCycleはMCPサーバーです。 AIコーディングアシスタントが、エディタからDevCycleのフィーチャーフラグ、変数、バリエーション、およびターゲティングルールを作成、更新、管理できるようにします。.
プロジェクトのREADMEから生成された概要
DevCycle MCP server について
このMCP serverは、CursorやClaudeを使用する開発者が、コーディング環境から直接フィーチャーフラグやターゲティングルールを管理することを可能にします。ホストされたDevCycleサーバーに接続することで、AIアシスタントはローカルへのインストールを必要とせず、フィーチャー管理のライフサイクル全体を作成、更新、監視する能力を獲得します。セットアップはエディタの設定による簡単な構成で行われ、初回使用時には安全な認証のためにOAuthが使用されます。
この統合により、AIは機能、変数、バリエーション、ターゲティングルールを含む複雑なDevCycleコンポーネントとやり取りできるようになります。単なるフラグ管理にとどまらず、コードベース内での変数の使用検出、型安全な実装のためのTypeScript型定義の生成、セルフターゲティングによるオーバーライドの管理など、高度な開発ワークフローをサポートします。AIアシスタントとDevCycleのこの連携により、フィーチャーのロールアウトや設定変更を、既存の開発ワークフロー内で直接実行できます。
できること
- 1フィーチャーフラグ管理の自動化AIアシスタントに、エディタ内で直接フィーチャーフラグやターゲティングルールを作成または変更するよう指示します。
- 2コードベースの変数監査ソースコード内に現在存在するすべてのDevCycle変数の使用リストをリクエストします。
- 3型安全なフラグ実装AIアシスタントにTypeScriptの定義を生成させ、フィーチャーフラグの使用を型安全にします。
- 4オーバーライドによる迅速なテストセルフターゲティングによるオーバーライドを使用して変数の値を切り替え、迅速なテストを行うようAIに指示します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
DevCycle MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにDevCycle MCPをインストール
$ claude mcp add --transport http cli https://mcp.devcycle.com/mcpCursorにDevCycle MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"url": "https://mcp.devcycle.com/mcp"
}
}
}VS CodeにDevCycle MCPをインストール
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "http",
"url": "https://mcp.devcycle.com/mcp"
}
}
}VS Code CLIにDevCycle MCPをインストール
$ code --add-mcp '{"name":"cli","type":"http","url":"https://mcp.devcycle.com/mcp"}'CodexにDevCycle MCPをインストール
$ codex mcp add cli --url https://mcp.devcycle.com/mcpCodex config.tomlにDevCycle MCPをインストール
~/.codex/config.toml
[mcp_servers.cli] url = "https://mcp.devcycle.com/mcp"
Gemini CLIにDevCycle MCPをインストール
$ gemini mcp add -s user --transport http cli https://mcp.devcycle.com/mcpGemini settings.jsonにDevCycle MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"url": "https://mcp.devcycle.com/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月13日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能devcyclehq/cli is public and reachablegithub.com/devcyclehq/cli ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-09github.com/devcyclehq/cli ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答HTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見るDevCycle CLI & MCP Server
This repository contains the DevCycle CLI for managing feature flags from the command line, plus an MCP (Model Context Protocol) server that enables AI coding assistants to interact with DevCycle.
Major features include:
- Fully manage your Features, Variables, Variations and Targeting Rules from the command line
- Detect and list DevCycle Variable usages in your codebase
- Manage your Self-Targeting Overrides to quickly switch between Variable values
- Generate type definitions for type-safe usage of DevCycle (Typescript only)
- MCP (Model Context Protocol) server for AI-powered feature flag management with Cursor and Claude
The CLI can be customized in several ways using command-line args or by creating a configuration file.
- Command Topics
- Pattern captures the key including surrounding quotes
- Pattern strips quotes, capturing only the content
MCP Server for AI Assistants
The DevCycle MCP (Model Context Protocol) server enables AI coding assistants like Cursor and Claude to manage feature flags directly from your development environment. DevCycle offers a hosted MCP server that requires no local installation.
Quick Setup (No Installation Required)
-
Configure your AI assistant to use the hosted MCP server:
-
Cursor: Add to
.cursor/mcp_settings.json:{ "mcpServers": { "devcycle": { "url": "https://mcp.devcycle.com/mcp" } } } -
Claude Desktop: Add to your Claude config file:
{ "mcpServers": { "devcycle": { "command": "npx", "args": [ "mcp-remote", "https://mcp.devcycle.com/mcp" ] } } }
-
-
That's it! The server will guide you through OAuth authentication when you first use it.
Your AI assistant can now create, update, and manage feature flags on your behalf.
For local installation options, detailed configuration, available tools, and advanced usage, see the complete MCP documentation.
CLI Documentation
Setup
Install the CLI
Using NPM
$ npm install -g @devcycle/cli
Or alternatively, using homebrew
$ brew tap devcyclehq/cli
$ brew install devcycle
Authentication
Many of the CLI commands require DevCycle API authorization. There are several ways to provide these credentials.
Using Access Tokens (preferred)
Login Command
By using the login sso command, the CLI will retrieve and store an access token, which is valid for 24 hours.
The login again command can be used to retrieve a new access token using the saved project and organization without prompting for them.
This process will open browser windows to interact with the DevCycle universal login page. It will first obtain a personal access token, then prompt you to choose an organization. A second browser window is used to authenticate the CLI with your chosen organization.
To switch organizations once logged in, the organizations select command can be used.
If executing the CLI in a containerized environment, please ensure one of the following PORTs can be accessed via Port Forwarding: 2194 (default), 2195, 2196 or 8080. This will allow the authentication process to complete and set the access token appropriately.
Repo Init Command
The repo init command behaves in the same way as login sso, but creates a repo configuration file and stores the project and organization choices there instead.
Using Client Credentials
Client Credentials in Auth File
Use the dvc status command to find the configuration file location for your platform. The credentials can be stored in the file pointed to by the Auth config path. Create the file if it does not exist, with the following contents.
clientCredentials:
client_id: <your client id>
client_secret: <your client secret>
This file should not be checked in to version control.
The default location is based on the oclif configDir
If you intend to run the CLI using options that override config file locations, the dvc status command command can be run with those options to confirm that the file locations are as expected.
Project Selection
You also need to specify the default project ID for the CLI to use.
If there is a repo configuration file, the dvc diff and dvc usages commands will use the project defined there.
Otherwise, this is chosen during login or set using the project select command
Environment Variables
Set the following environment variables:
$ export DEVCYCLE_CLIENT_ID=<your client id>
$ export DEVCYCLE_CLIENT_SECRET=<your client secret>
$ export DEVCYCLE_PROJECT_KEY=<your project key>
Command-Line Arguments
The CLI can be run with the following arguments:
$ dvc --client-id=<your client id> --client-secret=<your client secret> --project=<your project key>
Github Action
The Devcycle Github actions are configured with auth information through the project-key, client-id and client-secret configuration parameters. This is passed to the CLI via command line arguments.
Usage
$ npm install -g @devcycle/cli
$ dvc COMMAND
running command...
$ dvc (--version)
@devcycle/cli/6.6.1 linux-x64 node-v24.21.0
$ dvc --help [COMMAND]
USAGE
$ dvc COMMAND
...
Command Topics
dvc alias- Manage repository variable aliases.dvc autocomplete- display autocomplete installation instructionsdvc cleanup- Replace a DevCycle variable with a static value in the current version of your code. Currently only JavaScript is supported.dvc diff- Print a diff of DevCycle variable usage between two versions of your code.dvc environments- Create a new Environment for an existing Feature.dvc features- Create, view, or modify Features with the Management API.dvc generate- Generate Devcycle related files.dvc help- Display help for dvc.dvc identity- View or manage your DevCycle Identity.dvc keys- Retrieve SDK keys from the Management API.dvc login- Log in to DevCycle.dvc logout- Discards any auth configuration that has been stored in the auth configuration file.dvc organizations- List or switch organizations.dvc overrides- Create, view, or modify Overrides for a Project with the Management API.dvc projects- Create, or view Projects with the Management API.dvc repo- Manage repository configuration.dvc status- Check CLI status.dvc targeting- Create, view, or modify Targeting Rules for a Feature with the Management API.dvc usages- Print all DevCycle variable usages in the current version of your code.dvc variables- Create, view, or modify Variables with the Management API.dvc variations- Create a new Variation for an existing Feature.
Repo Configuration
The following commands can only be run from the root of a configured repository
Many of the options available as command-line args can also be specified using a repo configuration file. The default
location for this file is <REPO ROOT>/.devcycle/config.yml.
This location can be overridden using the --repo-config-path flag.
The configuration file format is documented below:
## the project and organization to use when connecting to the DevCycle Rest API for this repo
project: "project-key"
org:
id: "org_xxxxxx"
name: "unique-org-key"
display_name: "Human Readable Org Name"
## block for configuring "code insights" features like diff and variable usage scanning
## use this section to improve the detection of DevCycle usage within your code
codeInsights:
## add additional names to check for when looking for instances of DVCClient from an SDK
clientNames:
- "dvcClient"
## map the values used in your code to the corresponding variable key in DevCycle
variableAliases:
"VARIABLES.ENABLE_V1": "enable-v1"
## additional regex patterns used to match variables for a specific file extension
matchPatterns:
## file extension to override for, containing a list of patterns to use
js:
- dvcClient\.variable\(\s*["']([^"']*)["']
## an array of file glob patterns to include in usage scan
includeFiles:
- "*.[jt]s"
## an array of file glob patterns to exclude from usage scan
excludeFiles:
- "dist/*"
Match Patterns and Aliases
When identifying variable usages in the code, the CLI will identify DevCycle SDK methods by default. To capture other usages you may define match patterns. Match patterns are defined by file extension.
:::note Each pattern must include exactly one capture group for the variable key. Capture the entire key value (including surrounding quotes if you choose the “with quotes” pattern). :::
Match patterns can be defined in the configuration file, for example:
codeInsights:
matchPatterns:
js:
- customVariableGetter\(\s*["']([^"']*)["']
ts:
- customVariableGetter\(\s*["']([^"']*)["']
jsx:
- customVariableHook\(\s*["']([^"']*)["']
- customVariableGetter\(\s*["']([^"']*)["']
tsx:
- customVariableHook\(\s*["']([^"']*)["']
- customVariableGetter\(\s*["']([^"']*)["']
Capturing with or without quotes
Match patterns can capture variable keys with or without quotes, which affects whether aliases are needed:
With quotes:
# Pattern captures the key including surrounding quotes
- dvcClient\.variable\(\s*(["'][^"']*["'])\s*,
- Matches:
dvcClient.variable('my-variable', default) - Captures:
'my-variable'(with quotes)
Without quotes (aliases or generated constants required):
# Pattern strips quotes, capturing only the content
- dvcClient\.variable\(\s*["']([^"']*)["']
- Matches:
dvcClient.variable('my-variable', default) - Captures:
my-variable
Match patterns can also be passed directly to relevant commands using the --match-pattern flag:
dvc usages --match-pattern ts="customVariableGetter\(\s*["']([^"']*)["']" js="customVariableGetter\(\s*["']([^"']*)["']"
When testing your regex the --show-regex flag can be helpful. This will print all patterns used to find matches in your codebase.
dvc usages --show-regex
Custom Wrapper Functions
If you use wrapper functions around the SDK, add patterns for them.
Example: Custom wrapper functions
codeInsights:
matchPatterns:
ts:
# Matches: getFeatureFlag('my-variable', defaultValue)
- getFeatureFlag\(\s*([^,)]*)\s*,
# Matches: isFeatureEnabled('my-variable')
- isFeatureEnabled\(\s*([^,)]*)\s*\)
tsx:
# Matches: useFeatureFlag('my-variable', defaultValue)
- useFeatureFlag\(\s*([^,)]*)\s*,
DevCycle MCPのよくある質問
DevCycle MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http cli https://mcp.devcycle.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
DevCycle MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
DevCycle MCP serverにはOAuth認証が必要ですか?
はい、ホストされたサーバーを使用する際、初回にOAuth認証の手順が案内されます。
MCPを通じて、AIアシスタントはDevCycleのフィーチャーフラグに対してどのような操作ができますか?
機能、変数、バリエーション、ターゲティングルールを含むフィーチャーフラグを、ユーザーに代わって作成、更新、管理できます。
どのAIアシスタントがDevCycle MCP serverに対応していますか?
CursorやClaudeなどのAIコーディングアシスタント向けに設計されており、両方のセットアップ用スニペットも用意されています。