MCP Server Starter

A production-ready starter template for building Model Context Protocol (MCP) servers with TypeScript.

🚀 Quick Start

Clone the repository
Install dependencies:
bun install

✨ Key Features

Bun for fast testing and development
Biome for linting and formatting
Automated version management with standard-version
Clean, maintainable project structure

📂 Project Structure

mcp-starter/
├── src/
│   ├── tools/          # MCP tools implementation
│   ├── utils/          # Shared utilities
│   ├── main.ts         # Server entry point
│   └── types.ts        # Shared type definitions
├── tests/              # Test files
├── biome.json          # Linting configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Project dependencies

⚙️ Configuration

Creating New Tools

The project includes a script to help create new MCP tools:

bun run scripts/create-tool.ts <tool-name>

This will:

Create a new tool directory under src/tools/<tool-name>
Generate the basic tool structure including:
- index.ts (main implementation)
- schema.ts (JSON schema for tool parameters)
- test.ts (test file)
Update the tools index file to export the new tool

Example:

bun run scripts/create-tool.ts weather

🛠️ Development

Run tests: bun test
Format code: bun run format
Lint code: bun run lint
Build project: bun run build

To add your development MCP server to Claude Desktop:

Build the project:
bun run build
Add to your Claude Desktop config:
// You only need the argument if you need to pass arguments to your server { "mcpServers": { "your-server-name": { "command": "node", "args": ["/path/to/your/project/dist/main.js", "some_argument"] } } }

📜 Version Management

This project uses standard-version for automated version management. Run bun run release to create a new version.

Commit Message Format

feat: New feature (bumps minor version)
fix: Bug fix (bumps patch version)
BREAKING CHANGE: Breaking change (bumps major version)

📦 Publishing to npm

Ensure you're logged in to npm:
npm login
Build the project:
bun run build
Publish the package:
npm publish

Remember to update the version number using bun run release before publishing new versions.

Installing from npm (after publishing)

Add to your Claude Desktop config:

// You only need the argument if you need to pass arguments to your server
{
  "mcpServers": {
    "your-server-name": {
      "command": "npx",
      "args": ["-y", "your-package-name", "some_argument"]
    }
  }
}

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

Tools

hello_tool

A production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Starter
coinselor
A
security
A
license
A
quality
A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
Last updated -
1
7
JavaScript
MIT License
MCP Server Template
stevennevins
A
security
F
license
A
quality
A TypeScript-based template for developing Model Context Protocol servers with features like dependency injection and service-based architecture, facilitating the creation and integration of custom data processing tools.
Last updated -
1
2
TypeScript
MCP Server Starter
GreatAuk
A
security
A
license
A
quality
A TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.
Last updated -
1
7
2
TypeScript
MIT License
MCP Framework
ronangrant
-
security
F
license
-
quality
A TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.
Last updated -
67
TypeScript

View all related MCP servers

MCP Server Starter