Mcp Server Kit

# MCP Server Kit

A TypeScript starter template for building [Model Context Protocol](https://modelcontextprotocol.io/) (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

```bash
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:

```bash
npm run generate 

... [View full README on GitHub]