The MCP Server Starter is a production-ready template for building Model Context Protocol (MCP) servers with TypeScript, providing a development environment with tools for creating and managing server functionalities.
Development Tools: Includes commands for testing, formatting, linting, building, version management, and publishing to npm.
Tool Creation: Create new tools easily using
bun run scripts/create-tool.ts <tool-name>, which generates necessary files and integrates them.Example Capability: Comes with a basic
hello_toolthat requires anameparameter to generate personalized greetings.Claude Desktop Integration: The development MCP server can be added to Claude Desktop by specifying the server command and arguments in configuration.
Integrates with Biome for linting and formatting of the MCP server codebase.
Uses Bun for fast testing and development of the MCP server.
Supports publishing the MCP server as an npm package for easy distribution and installation.
Built with TypeScript for type-safe development of MCP servers.
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
Related MCP server: MCP Server Template
āØ 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
āļø Configuration
Creating New Tools
The project includes a script to help create new MCP tools:
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:
š ļø Development
Run tests:
bun testFormat code:
bun run formatLint code:
bun run lintBuild project:
bun run build
To add your development MCP server to Claude Desktop:
Build the project:
bun run buildAdd 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 loginBuild the project:
bun run buildPublish 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: