The MCP Server Starter is a production-ready template for building Model Context Protocol (MCP) servers with TypeScript. With this server, you can:
- Build custom tools: Create and manage various MCP tools efficiently, including the example 'hello_tool' that greets users by name.
- Streamline development: Quick setup with Bun for fast development, testing, linting, and formatting.
- Automate processes: Generate new tools with a script that creates the necessary structure and updates the tools index.
- Manage versions: Use standard-version for automated version management and publishing to npm.
- Integrate easily: Add the server to Claude Desktop by building the project and updating the configuration, either locally or via npm.
Integrates Biome for code linting and formatting, ensuring consistent code quality in the MCP server implementation.
Utilizes Bun for runtime execution and development environment, providing fast testing and execution capabilities for the MCP server.
Supports publishing the MCP server as an npm package, allowing for easy distribution and installation in Claude Desktop environments.
Built with TypeScript to provide type safety and improved developer experience when creating and implementing MCP tools.
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.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
A production-ready template for building Model Context Protocol servers with TypeScript, featuring Bun for fast development, Biome for linting, and an organized structure for creating MCP tools.
- 🚀 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
- AsecurityAlicenseAqualityA production-ready template for building Model Context Protocol servers in TypeScript, offering fast development with Bun, Biome linting, and automated version management.Last updated -17JavaScriptMIT License
- 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