Add support for MCP endpoints

[dan-lee]

Example here: https://zudoku-cosmo-cargo-git-feat-mcp-endpoint.zuplosite.com/catalog/api-ai-cargo/ai-operations#universal-mcp-endpoint

Adds basic MCP support to Zudoku. OpenAPI operations with x-mcp-server now show AI tool configuration instructions (Claude, Cursor, ChatGPT and VS Code).

• New MCPEndpoint component for displaying connection configs
• Auto-generates /mcp endpoint URLs
• Copy-to-clipboard for easy setup

x-mcp-server is an object and contain the displayed name of the MCP server:

"x-mcp-server": {
  "name": "my-sweet-mcp"
}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
zudoku-cosmo-cargo	Ready	Preview		Aug 19, 2025 1:03pm
zudoku-docs	Ready	Preview	Comment	Aug 19, 2025 1:03pm

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 3cec8a9

Command	Status	Duration	Result
nx run cosmo-cargo:build	✅ Succeeded	41s	View ↗
nx run zudoku:publish:local	✅ Succeeded	30s	View ↗

---

☁️ Nx Cloud last updated this comment at 2025-08-04 13:20:22 UTC

[github-actions]

Preview build of published Zudoku package for commit 3838415.

See the deployment at: https://658496a2.cosmocargo-public-package.pages.dev

Note

This is a preview of the Cosmo Cargo example using the Zudoku package published to a local registry to ensure it'll be working when published to the public NPM registry.

Last updated: 2025-08-19T13:02:24.310Z

[Copilot]

Pull Request Overview

This PR adds Model Context Protocol (MCP) support to Zudoku, enabling OpenAPI operations with x-mcp: true to display AI tool configuration instructions. The feature automatically generates MCP endpoint URLs and provides copy-to-clipboard functionality for easy setup with AI tools like Claude, Cursor, ChatGPT, and VS Code.

• Adds MCPEndpoint component that displays connection configurations for different AI tools
• Integrates MCP detection into OperationListItem to conditionally render MCP-specific UI
• Includes example AI Cargo API schema demonstrating MCP endpoint usage

Reviewed Changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
packages/zudoku/src/lib/plugins/openapi/MCPEndpoint.tsx	New component providing MCP connection configs and setup instructions for AI tools
packages/zudoku/src/lib/plugins/openapi/OperationListItem.tsx	Modified to detect and render MCP endpoints differently from regular operations
packages/zudoku/src/lib/ui/CodeBlock.tsx	Refactored className prop handling to apply to wrapper instead of inner div
packages/zudoku/package.json	Added tw-animate-css dependency
packages/zudoku/src/app/main.css	Imported tw-animate-css for animations
examples/cosmo-cargo/zudoku.config.tsx	Added AI Cargo API configuration
examples/cosmo-cargo/schema/ai-cargo.json	Example OpenAPI schema with MCP endpoint demonstration

Files not reviewed (1)

• pnpm-lock.yaml: Language not supported

Comments suppressed due to low confidence (2)

packages/zudoku/src/lib/plugins/openapi/MCPEndpoint.tsx:27

• The property name 'serverName' is inconsistent with the extension naming convention. Consider using 'name' to match the documented format in the PR description where x-mcp can contain a 'name' property.

      : (data?.serverName ?? summary ?? "mcp-server");

packages/zudoku/package.json:284

• The version 1.3.6 of tw-animate-css may not exist. The latest known version is around 1.0.x. Please verify this version exists or use a confirmed available version.

    "tw-animate-css": "1.3.6",