Skip to main content

​
New projects

1

Install sunpeak

Requirements: Node.js 20+Install sunpeak globally:
pnpm add -g sunpeak
2

Create a project

Create a new project:
sunpeak new my-app
3

Develop locally

Navigate to your project and run the development server:
cd my-app
sunpeak dev
This starts:
  • The MCP App simulator at http://localhost:3000 for local development
  • An MCP server at http://localhost:8000 for testing with real hosts like ChatGPT
Both servers support Hot Module Reload - your changes reflect instantly!
4

Test in a host (ChatGPT)

Run a tunnel to allow ChatGPT to connect to your local MCP server:
# In another terminal, run a tunnel. For example:
ngrok http 8000
You can then connect to the tunnel Forwarding URL at the /mcp path (e.g. https://your-random-subdomain.ngrok-free.dev/mcp) from ChatGPT in developer mode: User > Settings > Apps & Connectors > Create.

Project Scaffold

Explore your new MCP App project.