feat: Add Model Context Protocol (MCP) Server Support #467

jonathannorris · 2025-07-23T19:27:45Z

Summary

This PR introduces Model Context Protocol (MCP) server support to the DevCycle CLI, enabling AI coding assistants like Cursor and Claude to interact directly with DevCycle's feature flag management system.

What's Changed

New Features

MCP Server Implementation: Added a complete MCP server that exposes DevCycle functionality through standardized tools
Comprehensive Tool Set: Implemented 35+ tools covering:
- Feature flag management (create, update, delete, list)
- Variable management
- Environment and SDK key management
- Project management
- Self-targeting and overrides
- Targeting rules and audience configuration
- Audit log history

Technical Improvements

Enhanced API Client: Updated the API client to support all MCP operations
Zod Schema Integration: Added type-safe request/response handling using Zod schemas
Request Header Tracking: Added MCP-specific headers for analytics and debugging
Error Handling: Comprehensive error handling with detailed validation messages

Documentation & Developer Experience

Extensive Documentation: Added 510+ lines of comprehensive MCP documentation
Planning Documents: Included architectural planning and abstraction summaries
Cursor Rules: Added project-specific rules for API patterns, CLI commands, testing, and UI patterns
Dashboard Links: All tool responses include relevant DevCycle dashboard links

Infrastructure Updates

Updated to Yarn 4.9.2
Added MCP binary scripts for cross-platform support
Added @modelcontextprotocol/sdk dependency

Usage

After installation, developers can:

Manage feature flags directly from their AI assistant
Update targeting rules without leaving the editor
Create and modify variables with type safety
View audit logs and feature history
Set local overrides for testing

Testing

The implementation includes comprehensive validation and error handling to ensure safe operations, with warnings for production environment changes.

…#276) * DVC-8635 [feat]: add CLI command to clear all overrides for a project * DVC-8635 [chore]: update output to better reflect output success, warning or failure * DVC-8635 [fix]: update identity update & overrides clear commands to respect headless flag

…rompt manually in create command (#281) * chore: remove variable feature prompt from create variable prompts, prompt manually in create command * chore: added test for attaching feature to variable

override get command logic for when a feature and environment are specified

…ject (#282)

…tap (#286)

…t type display order (dev, staging, prod) (#287)

…eds to

…lues (#290)

* Update Create Feature description to make creating a new feature easier * another update * more description tweaks * chore: update create_feature description * chore: update description again --------- Co-authored-by: Jonathan Norris <jonathan@taplytics.com>

cloudflare-workers-and-pages · 2025-08-01T14:58:59Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	devcycle-mcp-server	`aa9d14c`	Aug 11 2025, 09:28 PM

…rsion from package.json

Making sure create feature names all targeting rules it creates

…hape

* fix: replace z.array(z.any()) with z.array(z.unknown()) for MCP schema compatibility * test: add MCP schema validation tests to prevent array items issues * fix: types in tests

…tions (#486) * refactor(mcp): unify header setting between CLI and Worker implementations * chore: cleanup TS worker config * feat: add destructiveHint to self-targeting tools * fix: env.ENABLE_OUTPUT_SCHEMAS support * chore: cleanup setting mcp headers * chore: cleanup

Copilot

Pull Request Overview

This PR introduces comprehensive Model Context Protocol (MCP) server support to the DevCycle CLI, enabling AI coding assistants like Cursor and Claude to directly interact with DevCycle's feature flag management system through standardized tools.

Key Changes:

Complete MCP server implementation with 35+ tools for feature flag, variable, environment, and project management
Enhanced API client with Zod schema integration and comprehensive error handling
Cloudflare Worker deployment for hosted MCP service accessible via OAuth

Reviewed Changes

Copilot reviewed 52 out of 310 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
src/mcp/tools/*.ts	Individual tool implementations for features, projects, environments, variables, results, and self-targeting
src/mcp/server.ts	Core MCP server implementation with tool registration and error handling
src/mcp/index.ts	Main entry point for standalone MCP server execution
src/api/*.ts	Enhanced API functions with additional parameters and new endpoints
mcp-worker/src/*.ts	Cloudflare Worker implementation with OAuth authentication
package.json	Added MCP SDK dependency and updated to Yarn 4.9.2

Copilot · 2025-08-11T21:19:34Z

src/mcp/tools/projectTools.ts

+        'listProjects',
+        args,
+        async (authToken: string) => {
+            console.log('listProjectsHandler args: ', args)


Debug console.log statements should be removed in production code. Consider using a proper logging framework or removing this debug statement.

Suggested change

console.log('listProjectsHandler args: ', args)

Copilot · 2025-08-11T21:19:34Z

src/api/zodClient.ts

 import { makeApi, Zodios, type ZodiosOptions } from '@zodios/core'
 import { z } from 'zod'

+/**


Excellent documentation about MCP schema compatibility. This is a critical implementation detail that prevents runtime issues with the MCP protocol.

Copilot · 2025-08-11T21:19:35Z

src/api/apiClient.ts

+                        JSON.parse(referrerMetadata)
+                    isCallerCli = parsedDvcReferrerMetadata.caller === 'cli'
+                }
+            } catch (parseError) {


Good defensive programming - the error handling for JSON parsing prevents crashes when referrer metadata is malformed.

Copilot · 2025-08-11T21:19:35Z

mcp-worker/.dev.vars

+# Replace these with your actual Auth0 values from https://manage.auth0.com/
+
+AUTH0_CLIENT_ID=NpnZJH8kJ6ZrU4tDPGVMunJA6cHMt0At
+AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf
+


Development credentials are exposed in the repository. While these appear to be development/test credentials, consider using placeholder values in the committed file and document how to obtain actual credentials.

Suggested change

# Replace these with your actual Auth0 values from https://manage.auth0.com/

AUTH0_CLIENT_ID=NpnZJH8kJ6ZrU4tDPGVMunJA6cHMt0At

AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf

# Replace the placeholder values below with your actual Auth0 credentials from https://manage.auth0.com/

# DO NOT commit real credentials to the repository.

AUTH0_CLIENT_ID=YOUR_AUTH0_CLIENT_ID

AUTH0_CLIENT_SECRET=YOUR_AUTH0_CLIENT_SECRET

Copilot · 2025-08-11T21:19:35Z

mcp-worker/.dev.vars

+# Replace these with your actual Auth0 values from https://manage.auth0.com/
+
+AUTH0_CLIENT_ID=NpnZJH8kJ6ZrU4tDPGVMunJA6cHMt0At
+AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf


Development credentials are exposed in the repository. Client secrets should never be committed to version control, even for development environments.

Suggested change

AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf

# Set your Auth0 client secret here for local development. Do NOT commit real secrets to version control.

AUTH0_CLIENT_SECRET=YOUR_AUTH0_CLIENT_SECRET_HERE

Copilot · 2025-08-11T21:19:36Z

src/mcp/tools/featureTools.ts

+        async (authToken: string, projectKey: string | undefined) => {
+            if (!projectKey) {
+                throw new Error(
+                    'Project key is required for this operation. Please selecting a project first.',


Typo in error message: 'selecting' should be 'select'. Should read 'Please select a project first.'

Suggested change

'Project key is required for this operation. Please selecting a project first.',

'Project key is required for this operation. Please select a project first.',

* feat: add MCP server, recover code from #467 * feat: add all new code * fix: getCurrentProject handler and refactor project formatting to use common utilities * docs: add cursor rules for project guidelines * feat: add local MCP project selection and consolidate utilities - Add project selection tool for local MCP (localProjectTools.ts) - Extract shared config management utility (configManager.ts) - Consolidate dashboard link generation (dashboardLinks.ts) - Update all MCP tools to use centralized dashboard links - Enhance DevCycleAuth with project persistence methods * docs: streamline mcp-worker README for clarity and conciseness * docs: update mcp.md to reflect current implementation and remove disabled tools * chore: clean up auth logging * refactor: use centralized dashboard links in project selection tools * feat: add root route redirect to MCP documentation * refactor: update description formatting and fix import paths in mcp tools * fix: preserve writer headless setting in ConfigManager constructor

kaushalkapasi and others added 30 commits September 5, 2023 15:23

feat: add dvc overrides clear for feature and environment

d205b04

feat: Output message when no variables changed in diff

788f982

Release v5.7.0

29d6630

feat: add overrides update

e2cf12a

chore: remove variable feature prompt from create variable prompts, p…

ddd189d

…rompt manually in create command (#281) * chore: remove variable feature prompt from create variable prompts, prompt manually in create command * chore: added test for attaching feature to variable

overrides get command for a specified feature (#278)

3d23860

override get command logic for when a feature and environment are specified

DVC-8696 [feat]: add ability to get all Overrides for a user in a pro…

1bdbd73

…ject (#282)

Release v5.8.0

fcda32d

DVC-8773 [feat]: add overrides list command (#283)

3666b90

chore: overrides update command to print results in table

df89ff4

chore: add repository dispatch step when publishing cli for homebrew …

4ababfe

…tap (#286)

chore: filter prompts to only overrides related information

2008e42

DVC-8827 [fix]: adds defaults sort by feature name then by environmen…

02a044f

…t type display order (dev, staging, prod) (#287)

Release v5.9.0

d7af9a2

Only update selected variation values instead of overriding all (#288)

5ab2176

Release v5.9.1

14e9bf5

fix: Update repo init command to not open browser window unless it ne…

13d3314

…eds to

Release v5.9.2

84cd552

chore: added gitlab pr insights and code usages as possible caller va…

485de70

…lues (#290)

fix: added gitlab pr insights and code usages (#293)

e418a7e

chore: Add additional docs on match patterns

8c202d2

feat: add info comments to type generator

907fd00

Release v5.10.0

388441c

feat: Add handling for gitlab pr links

20851db

fix: Don't include lines less than 1 in the code snippet buffer

4704ac3

Release v5.10.1

2e97987

[fix] Add timeout to sso login

fbeaba2

Release v5.10.2

81c98af

feat: add command to display current project

4f8059b

jonathannorris and others added 2 commits August 1, 2025 09:40

feat: update consent screen

d8224a2

jonathannorris added 7 commits August 1, 2025 11:16

chore: cleanup workerApiClient.ts

8b3e80d

chore: cleanup mcp /api folder

d2634a6

feat: update error handling

c3f762c

chore: update oauth refresh logs

fb50bf5

fix: projectKey error handling

703affa

chore: add environments and sdkKeys to select project output

e23dc2e

feat: update select_project tool description

c9b2732

jonathannorris requested a review from Copilot August 5, 2025 18:10

This comment was marked as outdated.

Sign in to view

jonathannorris and others added 10 commits August 5, 2025 14:29

test: fix mcp server error handling test assertions

4bb56fe

chore: update zod version

11521bd

chore: update dependancies

3dd2e71

chore: cleanup tool installation and docs

098bf92

feat: add per-operation MCP analytics headers in Worker and source ve…

a902bd1

…rsion from package.json

Update create_feature (#483)

7385e6a

Making sure create feature names all targeting rules it creates

docs: update MCP docs to match current MCP implementation and error s…

daf5714

…hape

chore: add back oclif.manifest.json

a804328

fix(mcp): MCP schema validation error for array types (#485)

0c9ec0c

* fix: replace z.array(z.any()) with z.array(z.unknown()) for MCP schema compatibility * test: add MCP schema validation tests to prevent array items issues * fix: types in tests

jonathannorris requested a review from Copilot August 11, 2025 21:02

Copilot AI reviewed Aug 11, 2025

View reviewed changes

chore: add .dev.vars to .gitignore

aa9d14c

jonathannorris closed this Aug 11, 2025

jonathannorris force-pushed the feat-mcp-server branch from e7780b1 to aa9d14c Compare August 11, 2025 21:26

jonathannorris added a commit that referenced this pull request Aug 12, 2025

feat: add MCP server, recover code from #467

3034fad

jonathannorris mentioned this pull request Aug 12, 2025

feat: Add Model Context Protocol (MCP) Server #487

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Add Model Context Protocol (MCP) Server Support #467

feat: Add Model Context Protocol (MCP) Server Support #467

Uh oh!

jonathannorris commented Jul 23, 2025 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages bot commented Aug 1, 2025 •

edited

Loading

Uh oh!

This comment was marked as outdated.

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Copilot AI Aug 11, 2025

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

16 participants

-# Replace these with your actual Auth0 values from https://manage.auth0.com/
-AUTH0_CLIENT_ID=NpnZJH8kJ6ZrU4tDPGVMunJA6cHMt0At
-AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf
+# Replace the placeholder values below with your actual Auth0 credentials from https://manage.auth0.com/
+# DO NOT commit real credentials to the repository.
+AUTH0_CLIENT_ID=YOUR_AUTH0_CLIENT_ID
+AUTH0_CLIENT_SECRET=YOUR_AUTH0_CLIENT_SECRET

	AUTH0_CLIENT_SECRET=ToEcJrTJjYsVgCSTWbjJ1mRVslcf5G7VuiLiCxRS77VkqAJAhkm_Qz0ipoDnWeZf
	# Set your Auth0 client secret here for local development. Do NOT commit real secrets to version control.
	AUTH0_CLIENT_SECRET=YOUR_AUTH0_CLIENT_SECRET_HERE

	'Project key is required for this operation. Please selecting a project first.',
	'Project key is required for this operation. Please select a project first.',

feat: Add Model Context Protocol (MCP) Server Support #467

feat: Add Model Context Protocol (MCP) Server Support #467

Uh oh!

Conversation

jonathannorris commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What's Changed

New Features

Technical Improvements

Documentation & Developer Experience

Infrastructure Updates

Usage

Testing

Uh oh!

cloudflare-workers-and-pages bot commented Aug 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

This comment was marked as outdated.

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Aug 11, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Milestone

Development

Uh oh!

16 participants

jonathannorris commented Jul 23, 2025 •

edited

Loading

cloudflare-workers-and-pages bot commented Aug 1, 2025 •

edited

Loading