The MCP Server Starter is a TypeScript-based framework for building and managing Model Context Protocol (MCP) tool servers.
- Create and manage MCP tools: Generate new tools with structured directories, implementations, schemas, and tests using the provided scripts.
- Hello tool: Includes a sample
hello_tool
that takes a requiredname
input and returns a greeting. - Development tools: Utilizes Bun for fast testing, Biome for linting/formatting, and standard-version for automated version management.
- JSON schema validation: Validates tool parameters through defined schemas.
- Claude Desktop integration: Easily configure your server to work with Claude Desktop.
- Publishing: Share your server as an npm package for others to use.
Used for linting and formatting code in the MCP server
Used for fast testing and development of the MCP server
The MCP server can be published to npm and installed from npm
The MCP server is built using TypeScript
MCP Server Starter
A production-ready starter template for building Model Context Protocol (MCP) servers with TypeScript.
🚀 Quick Start
- Clone the repository
- Install dependencies:
✨ 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 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:
- Add to your Claude Desktop config:
📜 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:
- Build the project:
- Publish the package:
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 must be authenticated.
Tools
A production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.
- 🚀 Quick Start
- ✨ Key Features
- 📂 Project Structure
- ⚙️ Configuration
- 🛠️ Development
- 📜 Version Management
- 📦 Publishing to npm
- Installing from npm (after publishing)
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.Last updated -1712JavaScriptMIT License
- AsecurityFlicenseAqualityA 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 -12TypeScript
- AsecurityAlicenseAqualityA 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 -172TypeScriptMIT License
- -securityFlicense-qualityA TypeScript framework for building Model Context Protocol (MCP) servers with automatic discovery and loading of tools, resources, and prompts.Last updated -67TypeScript
Appeared in Searches
- A platform for datasets and data management
- No-code platforms for application development using TypeScript, JavaScript, Python, with MCP server integration via agentic orchestration
- Setting Up AI Employee Tools on Docker Containers with MCP Servers
- Resources for Building Agentic AI
- Free and easy-to-setup Minecraft server hosting for solo web developers