notque/vexjoy-agent / skills/process/workflow
workflow
VerifiedStructured work: multi-phase tasks, feature builds, planning, objective loops, hill climbing.
references/mcp-pipeline-builder/references/ts-scaffold-template.md
View on GitHub# TypeScript MCP Server Scaffold Template
Reference for Phase 3 GENERATE. Templates for generating TypeScript MCP servers.
## Assembly
Generate a complete MCP server project:
```bash
python3 skills/process/workflow/references/mcp-pipeline-builder/scripts/assemble-scaffold.py \
--service github --entity issue --output-dir ./github-mcp-server
```
Or output a single file:
```bash
python3 scripts/assemble-scaffold.py --service github --entity issue --file package.json
```
Use `--list` to see all template files and key patterns.
Use `--help` for full parameter documentation.
## Template Files
| Output Path | Template | Purpose |
|-------------|----------|---------|
| `package.json` | `package.json.tmpl` | npm config with MCP SDK + Zod deps |
| `tsconfig.json` | `tsconfig.json.tmpl` | ES2022/Node16 TypeScript config |
| `src/index.ts` | `index.ts.tmpl` | McpServer init, transport, env var validation |
| `src/tools/*.ts` | `tools.ts.tmpl` | Tool registration with Zod schemas + annotations |
| `src/services/client.ts` | `client-http.ts.tmpl` | HTTP API client pattern |
| `src/services/client-cli.ts` | `client-cli.ts.tmpl` | Subprocess/CLI client pattern |
| `README.md` | `readme.md.tmpl` | Setup docs with Claude Code registration |
## Key Patterns
- **Tool annotations**: `readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`
- **Error handling**: Always return text content on error, never throw from tool handler
- **Auth**: Read credentials from env vars, throw at startup if missing
- **Logging**: Use `console.error()` (not `console.log`) with stdio transport
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |