Mcp StarterSAFE

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

🚀 Quick Start

1. Clone the repository
2. 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 

This will:

1. Create a new tool directory under src/tools/
2. Generate the basic tool structure including:
3. index.ts (main implementation)
4. schema.ts (JSON schema for tool parameters)
5. test.ts (test file)
6. 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:

1. Build the project:

bun run build

1. 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](https://gith