# MCP Server Scaffolding

> Scaffold production-ready MCP servers with TypeScript, tests, CI, and best practices. Use when you scaffold mcp server, create mcp server, generate mcp typescript, agent plugin packaging, or need plugin.json, mcp.json, and skills for Agent Plugins 1.0.0.

- Skill: `ofershap/mcp-server-scaffolding` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ofershap/mcp-server-scaffolding`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ofershap/mcp-server-scaffolding/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ofershap (https://skillmd.com/u/ofershap)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ofershap/mcp-server-scaffolding

---


# MCP Server Scaffolding

Use this skill when you need to create a new MCP server from scratch. Generates a production-ready project with TypeScript, Vitest tests, GitHub Actions CI, and error handling patterns.

## Usage

```bash
npx create-mcp-server-pro my-server
```

### Non-Interactive (Agent-Friendly)

```bash
npx create-mcp-server-pro my-server \
  --name mcp-server-weather \
  --description "Weather forecasts for AI assistants" \
  --auth \
  --author "Your Name"
```

## What Gets Generated

- TypeScript with strict mode and MCP SDK v2
- Vitest test setup with a sample tool test
- GitHub Actions CI pipeline
- Error handling patterns (MCP-compliant error responses)
- Agent-friendly README with tool table, quick start, and examples
- Agent Plugins 1.0.0 files (`plugin.json`, `mcp.json`, `skills/`, `llms.txt`)
- ESLint 9 + Prettier config
- Optional auth boilerplate (API token validation)

## Key Patterns

- Pass `--auth` for servers that need an API token; `--no-auth` for zero-config servers
- The generated `src/index.ts` has a working example tool — replace it with your real tools
- Tests use `@modelcontextprotocol/sdk/test` utilities for MCP protocol-level testing
- The official MCP scaffolder was archived — this is the maintained replacement