MCP App Framework for Building, Testing, and Shipping Agentic Apps
sunpeak is an open-source MCP App framework for building, testing, and shipping MCP Apps that run on ChatGPT, Claude, and every MCP-compatible host from a single codebase.
pnpm add -g sunpeak && sunpeak new
Definition
The sunpeak MCP App framework is an open-source toolkit for building, testing, and shipping MCP Apps across ChatGPT, Claude, and every MCP-compatible host from a single codebase. It includes a local multi-host inspector, CLI scaffolding, pre-built UI components, Playwright testing, and production server tooling.
What is an MCP App Framework?
MCP Apps are interactive applications built on the Model Context Protocol that run inside AI hosts like ChatGPT and Claude. They display rich UI components, handle user interactions, and connect to external services through MCP servers.
An MCP App framework handles the complexity of building these apps: project structure, local development, host simulation, testing, and deployment. Because MCP is a standard protocol, apps built with the right framework work across every compatible host without rewriting code.
sunpeak is that framework. Write your app once, test it locally against any host's inspector, and ship it to ChatGPT, Claude, or any future MCP host from one codebase.
Write Once, Run on Every MCP Host
Your MCP App
One codebase, portable by default
ChatGPT
Claude
Any Host
Portable by Default
Your MCP App resources and tools work on any MCP host. Core sunpeak APIs like
useToolData,
useHostContext, and
useTheme abstract host differences so your code stays the same.
Optional Host-Specific Features
Need ChatGPT-specific display modes or Claude-specific behaviors? Import from
sunpeak/chatgpt or
sunpeak/claude
subpaths. These features layer on top of your portable base without coupling your app
to one host.
Single Test Suite
Test once with the sunpeak inspector. The same test suite validates your app across host configurations, so you catch issues before deploying to any host.
Test MCP Apps Locally
Use the sunpeak inspector for MCP App testing locally and in CI/CD. The inspector replicates the MCP App runtime for deterministic UI testing across host configurations.
How sunpeak works
Scaffold a Project
Run sunpeak new to create a new project with TypeScript, React, Vite, and MCP configuration pre-configured.
Develop Locally
Use the built-in MCP App inspector to develop and test your app without deploying. Hot Module Replacement (HMR) keeps your development loop fast.
Test Across Hosts
Validate your app works on ChatGPT, Claude, and other hosts using the inspector's host configuration. Connect to real hosts for integration testing with mock data and HMR.
Build and Ship
Run sunpeak build to generate production bundles, then sunpeak start to launch a production MCP server. Or mount on your own Express, Cloudflare Workers,
or any HTTP server.
Core Framework Features
- Local MCP App Inspector
A React-based inspector that replicates the MCP App environment for local development and automated testing across hosts.
- MCP App Component Library
Pre-built UI components that work across MCP hosts, following host design guidelines.
- Built-in MCP Server
A development MCP server that serves your resources with mock data and hot module replacement.
- TypeScript-First APIs
Strongly typed hooks and utilities for interacting with the MCP App runtime, host APIs, and state management. See the MCP Apps technical documentation.
- Testing Infrastructure
Vitest and Playwright integration for unit and end-to-end testing of MCP Apps across host configurations.
- Production Server
Zero-config production server with
sunpeak start, or mount on Express, Cloudflare Workers, and other runtimes.
Who sunpeak is for
Coding Agents
Agents like Claude Code, Codex, and Cursor can scaffold, build, and test MCP Apps with sunpeak's CLI and structured project conventions. No manual setup required.
React Developers
If you know React, you can build MCP Apps. sunpeak uses familiar patterns: functional components, hooks, and JSX.
MCP Server Authors
Decouple your MCP App resources from your MCP server. Develop and version them independently with sunpeak.
Teams Building for Multiple Hosts
Ship to ChatGPT, Claude, and other hosts without maintaining separate codebases. sunpeak's portable APIs keep your team productive.
Getting Started
Install sunpeak globally and create a new project:
pnpm add -g sunpeak && sunpeak new
This scaffolds a complete MCP App project with TypeScript, React, Vite, and the sunpeak
runtime pre-configured. Run sunpeak dev to start the development server with the MCP App inspector.
Frequently Asked Questions
What is an MCP App framework?
An MCP App framework provides the development infrastructure for building interactive applications that run inside AI hosts via the Model Context Protocol (MCP). sunpeak is an MCP App framework that includes a local inspector, pre-built UI components, testing utilities with Vitest and Playwright, and deployment tooling for building portable MCP Apps.
Do MCP Apps built with sunpeak work on ChatGPT and Claude?
Yes. sunpeak MCP Apps are portable by default. Core APIs like useToolData and useHostContext work on every MCP host including ChatGPT and Claude. Host-specific features are opt-in through subpath imports like sunpeak/chatgpt or sunpeak/claude, so your base app code stays the same across all hosts.
How do I test MCP Apps locally?
Run "sunpeak dev" to start the local inspector and MCP dev server at localhost:3000. The inspector replicates the MCP App runtime with hot reloading so you can test all display modes, themes, and tool invocations without a paid ChatGPT or Claude account.
What is the difference between an MCP App framework and a ChatGPT App framework?
A ChatGPT App framework targets ChatGPT specifically. An MCP App framework like sunpeak targets the MCP standard, so apps work across ChatGPT, Claude, and other MCP-compatible hosts. sunpeak is both — it provides a portable base with optional host-specific extensions.
Does sunpeak support host-specific features?
Yes. Import from sunpeak/chatgpt for ChatGPT-specific features like display modes and output templates, or sunpeak/claude for Claude-specific features. These layer on top of the portable base without coupling your app to one host.
Can I run MCP App tests in CI/CD?
Yes. sunpeak includes Vitest and Playwright integration for automated MCP App testing. Create simulation files for deterministic UI states and run "pnpm test" for unit tests or "pnpm test:e2e" for end-to-end tests in your CI/CD pipeline.
Is sunpeak open source?
Yes. sunpeak is MIT licensed and available on GitHub at github.com/Sunpeak-AI/sunpeak and npm at npmjs.com/package/sunpeak. It is free to use, modify, and distribute.
Open Source & MIT Licensed
sunpeak is free to use, modify, and distribute.
Testing MCP Apps? See the MCP App Inspector page.
Building specifically for ChatGPT? See the ChatGPT App Framework page. Building for Claude? See the Claude Connector Framework page.
