Skip to content

Conversation

@gocamille
Copy link
Contributor

@gocamille gocamille commented Dec 16, 2025

Problem

The local mcp-server.schema.json in the add-mcp template was outdated:

  • Using JSON Schema draft-07 (official apollo-mcp-server uses draft-2020-12)
  • Only 168 lines vs official 1045 lines
  • Missing critical fields: headers, graphos, telemetry, health_check, forward_headers, custom_scalars
  • Template YAML files showed false positive validation errors

Solution

Implemented automated schema synchronization from Apollo MCP Server releases:

1. Automated Workflows

  • Daily sync workflow - Checks for new releases from https://github.com/apollographql/apollo-mcp-server, checks for updates to the schema, and creates PRs when applicable
  • CI validation - Validates template YAML files against official schema on every PR

2. Schema Upgrade

  • Replaced local schema with official apollo-mcp-server v1.3.0 schema
  • Upgraded from draft-07 to draft-2020-12
  • Now includes all official config options

3. Template Cleanup

  • Removed invalid require_confirmation field (doesn't exist in apollo-mcp-server)
  • This field was being silently ignored at runtime

4. Process Documentation

  • Updated schemas README with sync process
  • Added VERSION tracking file
  • Updated CODEOWNERS for @gocamille review when a PR is generated

Testing

  • Schema validates correctly with ajv-cli
  • Template YAML files pass validation
  • VS Code autocomplete works for all official fields
  • No false positive errors on valid config

Breaking Changes

None - only removes invalid config that was already being ignored.

@gocamille gocamille requested a review from a team as a code owner December 16, 2025 20:29
@gocamille gocamille changed the base branch from main to release/v3 December 16, 2025 20:33
@gocamille gocamille merged commit e821580 into release/v3 Dec 16, 2025
5 checks passed
@gocamille gocamille deleted the feat/mcp-server-schema-sync branch December 16, 2025 21:46
gocamille added a commit that referenced this pull request Dec 16, 2025
* fix(deps): update sha.js to v2.4.12 to fix security vulnerability

Updated dependencies in start-with-typescript to resolve sha.js vulnerability (CVE). The vulnerability was fixed in sha.js version 2.4.12.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Implement automated apollo-mcp-server schema sync (#92)

* feat: add automated schema sync workflow

* feat: upgrade to official apollo-mcp-server schema v1.3.0

* feat: allow vscode directory to be committed to the repo

* feat: Ensure validation workflow does not error due to ajv

* feat: refine github mcp server workflow check

---------

Co-authored-by: Taylor Jones <[email protected]>
Co-authored-by: Claude <[email protected]>
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.

1 participant