✨ Add MCP App groundwork with Claude/Codex parity

[Vivekyy]

Adds a bundled stdio MCP server and single-file MCP App UI, wired through Codex’s direct .mcp.json and Claude’s compatible .claude-mcp.json while keeping equivalent launch behavior.

Extends build/package metadata, TypeScript DOM support, and npm contents so both hosts receive the server and UI artifacts.

Adds runtime, UI, packaging, coverage, and malformed-content tests, and updates the shared check skill to enforce Claude/Codex parity.

Refreshes CodeAlmanac package and contributor guidance; validated with typecheck, 51 tests, build, 90% diff coverage, Claude plugin validation, and npm pack dry-run.

---

Greptile Summary

Adds a bundled stdio MCP server and single-file MCP App with equivalent Claude and Codex launch paths.

• Registers the open_rudder tool and its associated HTML app resource.
• Adds provider manifests, package artifacts, build configuration, and dependencies.
• Adds server, UI, provider-parity, and packaging tests.
• Updates contributor checks and architecture documentation for MCP App support.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code defect identified.

The server, resource, UI bridge, build pipeline, package allowlist, and provider-specific launch configurations are internally consistent and covered across both Claude and Codex paths.

Important Files Changed

Filename	Overview
src/mcp/server.ts	Registers the read-only Rudder launch tool and its MCP App resource with matching structured output.
src/mcp/run-server.ts	Resolves the plugin root, loads package metadata and generated app HTML, and connects the MCP server to stdio or an injected transport.
ui/rudder-app.ts	Connects to the MCP Apps bridge and safely renders valid, absent, malformed, and unavailable-host states.
scripts/build-mcp-app.mjs	Bundles the browser entrypoint and embeds it into a generated single-file HTML resource.
package.json	Adds MCP dependencies, packaged configuration files, generated artifacts, UI coverage, and the expanded build pipeline.
test/mcp-server.test.ts	Covers tool and resource behavior plus packaged stdio startup through both provider environment paths.
test/plugin-package.test.ts	Enforces Claude/Codex configuration parity and inclusion of the MCP server and app artifacts.
test/ui.test.ts	Covers structured result rendering and UI fallback/error states.

Sequence Diagram

sequenceDiagram
    participant Host as Claude/Codex
    participant Launcher as MCP configuration
    participant Server as Rudder MCP server
    participant App as Rudder MCP App
    Host->>Launcher: Discover rudder server
    Launcher->>Server: Start bundled stdio server
    Host->>Server: Call open_rudder
    Server-->>Host: Structured launch result + resource URI
    Host->>Server: Read ui://rudder/workspace.html
    Server-->>Host: Single-file HTML resource
    Host->>App: Render app and deliver tool result

Loading

_{Reviews (1): Last reviewed commit: "✨ Add MCP App groundwork with provider p..." | Re-trigger Greptile}

[github-actions]

📦 No plugin release on merge

The plugin package, tag, and GitHub Release already exist for 0.1.4.
Bump package.json to release a new plugin version.

[ghost]

Ready to review this PR? Stage has broken it down into 8 individual chapters for you:

	Title
1	Update package metadata and build configuration
2	Implement the MCP server and app runtime
3	Build the single-file MCP App UI
4	Configure Claude and Codex provider parity
5	Verify MCP and UI with tests
6	Enforce provider parity in check skill
7	Update CodeAlmanac architecture and guides
8	Other changes

_{Chapters generated by Stage for commit cfca0f2 on Jul 30, 2026 8:09pm UTC.}