Skip to content

MCP platform server scaffolding#7596

Open
cstns wants to merge 8 commits into
mainfrom
7426_mcp-scaffolding
Open

MCP platform server scaffolding#7596
cstns wants to merge 8 commits into
mainfrom
7426_mcp-scaffolding

Conversation

@cstns

@cstns cstns commented Jun 22, 2026

Copy link
Copy Markdown
Contributor

Description

Lays the groundwork for the MCP platform tools server. No functional endpoint yet, just the wiring so subsequent PRs have somewhere to land.

  • Adds @modelcontextprotocol/sdk and zod as dependencies
  • Registers expertPlatformAutomation feature flag, same gate as expertAssistant (AI + expert enabled)
  • Reorganizes forge/ee/routes/mcp/: renames existing registration routes to registrations.js, adds empty server.js shell, new index.js router wires both up
  • Route shell at POST /api/v1/mcp returns 501 for now, gates on feature flag, rejects non-user tokens
  • Existing registration endpoints (/api/v1/teams/:teamId/mcp/*) are unchanged

Related Issue(s)

closes #7426

Checklist

  • I have read the contribution guidelines
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
    • Upgrade instructions
    • Configuration details
    • Concepts
  • Changes flowforge.yml?
    • Issue/PR raised on FlowFuse/helm to update ConfigMap Template
    • Issue/PR raised on FlowFuse/CloudProject to update values for Staging/Production
  • Link to Changelog Entry PR, or note why one is not needed.

Labels

  • Includes a DB migration? -> add the area:migration label

@codecov

codecov Bot commented Jun 23, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 21.67488% with 318 lines in your changes missing coverage. Please review.
✅ Project coverage is 75.35%. Comparing base (0c9b327) to head (12a7179).

Files with missing lines Patch % Lines
forge/ee/lib/mcp/tools/applications.js 0.00% 50 Missing ⚠️
forge/ee/lib/mcp/tools/snapshots.js 0.00% 40 Missing ⚠️
forge/comms/platformAutomation.js 23.52% 39 Missing ⚠️
forge/ee/lib/mcp/tools/devices.js 0.00% 35 Missing ⚠️
forge/ee/lib/mcp/toolLoader.js 0.00% 30 Missing ⚠️
forge/comms/commsClient.js 0.00% 29 Missing ⚠️
forge/ee/lib/mcp/tools/instances.js 0.00% 28 Missing ⚠️
forge/ee/lib/mcp/tools/navigation.js 0.00% 16 Missing ⚠️
forge/ee/routes/mcp/registrations.js 78.12% 14 Missing ⚠️
forge/ee/lib/mcp/tools/platform.js 0.00% 13 Missing ⚠️
... and 4 more
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7596      +/-   ##
==========================================
- Coverage   76.29%   75.35%   -0.94%     
==========================================
  Files         414      425      +11     
  Lines       22167    22487     +320     
  Branches     5870     5930      +60     
==========================================
+ Hits        16912    16945      +33     
- Misses       5255     5542     +287     
Flag Coverage Δ
backend 75.35% <21.67%> (-0.94%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@n-lark n-lark left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks good to me

Comment thread package.json Outdated
"@heroicons/vue": "2.1.5",
"@levminer/speakeasy": "^1.4.2",
"@node-red/util": "^5.0.0",
"@modelcontextprotocol/sdk": "^1.29.0",

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we'll be removing this once child branches are merged down, as 3rd party access is not a priority at the moment

#7598)

Co-authored-by: Steve-Mcl <sdmclaughlin@gmail.com>
Co-authored-by: Stephen McLaughlin <44235289+Steve-Mcl@users.noreply.github.com>
Co-authored-by: Andrea Palmieri <76187074+andypalmi@users.noreply.github.com>
Co-authored-by: andypalmi <andrea@flowfuse.com>

@andypalmi andypalmi left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We tested it thoroughly together during today's online meeting and fixed issues we saw together, so I am quite confident to give it the green light

@andypalmi

Copy link
Copy Markdown
Contributor

@cstns Let's update the PR description with all of the changes before merging please

@cstns cstns enabled auto-merge (squash) July 1, 2026 20:36
@cstns cstns disabled auto-merge July 1, 2026 20:38
andypalmi pushed a commit that referenced this pull request Jul 1, 2026
…omationsHandler integration

# Conflicts:
#	frontend/src/stores/context.js
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Scaffolding: Dependencies, Feature Flag, and Route Shell

3 participants