MCP, Router & Hooks

Mon, 01 Jan 0001 00:00:00 +0000

MCP (Model Context Protocol)#

MCP enables integration with external AI tools via a standardized JSON-RPC 2.0 protocol.

Transports#

Type	Description
stdio	Process: launched via command/args, communicates via stdin/stdout
http	Network: HTTP connection to a remote server

Configuration#

mcp:
 servers:
 - name: "my-server"
 transport: stdio
 command: "/path/to/mcp-server"
 args: ["--mode", "production"]
 env:
 CUSTOM_VAR: "${HOME}/config"
 auto_connect: true
 timeout: 15s

Auto-Healing#

Background check every 30 seconds
Tracks consecutive errors (threshold: 3)
Up to 10 reconnection attempts with exponential backoff (100ms → 30s)
Automatic reset on successful connection

Security#

StdioTransport sanitizes the environment: only whitelisted variables (PATH, HOME, PYTHONPATH, etc.) are passed to child processes.

User Interface

Mon, 01 Jan 0001 00:00:00 +0000

Gokin uses the Bubble Tea TUI framework with 3 themes, a command palette, and streaming output.

Themes#

Switch via /theme <name> or the ui.theme config.

Dark (default)#

Deep dark background with soft accents.

Element	Color	Hex
Primary	Soft Purple	`#A78BFA`
Secondary	Bright Cyan	`#22D3EE`
Success	Soft Green	`#34D399`
Warning	Warm Amber	`#FBBF24`
Error	Soft Red	`#F87171`
Muted	Neutral Gray	`#9CA3AF`
Text	Soft White	`#F1F5F9`
Background	Deep Navy	`#0F172A`
Border	Subtle Slate	`#1E293B`
Accent	Pink	`#F472B6`
Info	Teal	`#2DD4BF`

macOS#

Apple-inspired theme in SF UI style.

Advanced on Gokin