KnearMe MCP Worker Overview

Purpose

apps/knearme-mcp-worker is the Cloudflare Worker implementation of the KnearMe ChatGPT Apps MCP server.

It provides:

• MCP JSON-RPC endpoint surface.
• OAuth resource/issuer validation.
• Tool execution forwarding to portfolio API (current mode).
• Future path to runtime adapter / UserHome DO.

Runtime shape

• Current: ChatGPT -> MCP Worker -> Portfolio API.
• Planned: ChatGPT -> MCP Worker -> Runtime Adapter -> UserHomeDO.

Stack

• Cloudflare Workers + Wrangler.
• TypeScript.
• Tool schema validation via zod and zod-to-json-schema.
• JWT/OAuth token verification via jose.

Commands

pnpm -C apps/knearme-mcp-worker dev
pnpm -C apps/knearme-mcp-worker typecheck
pnpm -C apps/knearme-mcp-worker test
pnpm -C apps/knearme-mcp-worker deploy