MCP Server Kit

A TypeScript starter template for building Model Context Protocol (MCP) servers. Provides project structure, code generators, and conventions so you can focus on building tools, resources, and prompts.

Features

• ⚙️ TypeScript-first setup
• 🧩 Stdio-based MCP server
• 🛠 Generators for tools, prompts, and resources
• 🧹 Linting, formatting and type checking out of the box
• 📁 Clear, MCP-aligned project structure

What is MCP?

The Model Context Protocol is an open standard that enables LLM applications to connect to external data sources and tools. MCP servers expose three primitives:

• Tools — Actions the LLM can execute (e.g., query a database, call an API)
• Resources — Read-only data the LLM can access (e.g., database schema, config files)
• Prompts — Reusable templates with arguments (e.g., "design a table for X")

Tech Stack

Category	Technology
Runtime	Node.js
Language	TypeScript (strict mode)
Linting & Formatting	Biome
Schema Validation	Zod
MCP SDK	@modelcontextprotocol/sdk

Getting Started

nvm use         # Use the correct Node version
npm install     # Install dependencies
npm run build   # Build the project

The compiled server will be available at dist/server.js.

Project Structure

src/
├── server.ts      # Server entry point
├── lib/           # Shared utilities
├── prompts/       # MCP prompt definitions
├── resources/     # MCP resource definitions
└── tools/         # MCP tool implementations

Included Examples

The template includes working examples to demonstrate patterns:

Prompts

Prompt	Description
design-table	Takes a data description and generates PostgreSQL table design with example usage patterns

Resources

Resource	URI	Description
Schema	postgres://schema	Returns complete database schema with tables, columns, types, and constraints
Stats	postgres://stats	Returns database statistics: version, size, connections, and uptime

Tools

Tool	Description
sql-query-executor	Execute SQL queries against a PostgreSQL database

Code Generators

Scaffold new MCP components:

npm run generate           # Show all generator options
npm run generate:prompt    # Create a new prompt
npm run generate:resource  # Create a new resource
npm run generate:tool      # Create a new tool

Generators create the file and auto-register it with the server.

Commands

Command	Description
npm run build	Compile TypeScript to dist/
npm run lint	Check for linting and type errors
npm run lint:fix	Auto-fix linting issues
npm run format	Format code with Biome
npm run generate	Scaffold new MCP components
npm run generate:prompt	Scaffold a new prompt
npm run generate:resource	Scaffold a new resource
npm run generate:tool	Scaffold a new tool

MCP Client Compatibility

Some MCP features require specific client support. As of January 2026, most clients do not support:

• Elicitation — Interactive input requests from the server to the user
• Sampling — Server-initiated LLM completions

Check the MCP Clients documentation to see which features your client supports. As these features gain wider support, the examples in this template will be updated to demonstrate more advanced use cases.

License

MIT