The MCP Server Starter is a production-ready TypeScript template for building custom Model Context Protocol (MCP) servers. With this server, you can:
- Create and manage MCP tools using the provided script, which generates necessary files and tests
- Use the included
hello_tool
that takes aname
input and returns a greeting - Develop quickly with Bun for fast testing and development
- Maintain code quality through testing, formatting, and linting tools
- Automate version management using standard-version
- Publish your server to npm for distribution
- Integrate with Claude Desktop as an MCP server for workflows
Used for linting and formatting in the project
Used for fast testing and development in the project
The project can be published to npm registry
The project is built with TypeScript for type safety
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 via Smithery
To install Weather MCP Server Starter for Claude Desktop automatically via Smithery:
Installing from npm (after publishing)
Add to your Claude Desktop config:
You must be authenticated.
Tools
A TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.
- 🚀 Quick Start
- ✨ Key Features
- 📂 Project Structure
- ⚙️ Configuration
- 🛠️ Development
- 📜 Version Management
- 📦 Publishing to npm
- Installing via Smithery
- 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
- AsecurityFlicenseAqualityA template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.Last updated -15TypeScript
- -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
- 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
- How to Create MCP Servers
- Exploring the word 'Make' and its possible applications