How gmshadowe/chatgpt-workspace works
The repository contains a mostly default Next.js landing page and a separate MCP server that exposes workspace file-management tools over HTTP. The main runtime workflow is an MCP client request, session transport, tool dispatch, and workspace filesystem operation. The excerpts show Supabase clients being created, but not how they are used, so that integration is omitted.
Main entry points: index.ts HTTP Routes · layout.tsx Root Layout · page.tsx Home Page · globals.css Global Styles
Components 11
Workspace MCP
- HTTP Routes
mcp-server/src/index.ts - Session Transport
mcp-server/src/index.ts - MCP Server
mcp-server/src/index.ts - Tool Handler
mcp-server/src/index.ts - File Tools
mcp-server/src/index.ts - Workspace Files
mcp-server/src/index.ts
Starter Web UI
- Home Page
app/page.tsx - Root Layout
app/layout.tsx - Global Styles
app/globals.css
Other components
- MCP Client
- Browser User
Connections 10
- MCP Client → HTTP Routes: sends MCP requests
mcp-server/src/index.ts - HTTP Routes → Session Transport: creates or reuses
mcp-server/src/index.ts - HTTP Routes → MCP Server: connects server
mcp-server/src/index.ts - Session Transport → MCP Server: routes requests
mcp-server/src/index.ts - MCP Server → Tool Handler: dispatches tools
mcp-server/src/index.ts - Tool Handler → File Tools: selects operation
mcp-server/src/index.ts - File Tools → Workspace Files: reads and writes
mcp-server/src/index.ts - Browser User → Home Page: opens page
- Root Layout → Home Page: wraps page
app/layout.tsx - Root Layout → Global Styles: imports styles
app/layout.tsx