shellsage-ai/mcp-server-boilerplate

Production-ready starter templates for building Model Context Protocol servers in **TypeScript** and **Python**.
Skip the boilerplate. Start building tools your AI agents can actually use.
Server Capabilities
This boilerplate ships with working examples of all three MCP primitives:
Tools
| Tool | Description | Parameters |
|------|-------------|------------|
| echo | Echo a message back to the caller | message (string, required) |
| timestamp | Get the current UTC timestamp | _(none)_ |
Resources
| URI | Description | MIME Type |
|-----|-------------|-----------|
| server://info | Server metadata (name, version, available tools) | application/json |
Prompts
No prompt templates are registered in the starter. The full kit includes prompt template patterns.
What's Included (Free)
TypeScript Quickstart
Python Quickstart
Claude Desktop Configuration
Project Structure
Getting Started
1. Clone this repo
2. npm install
3. npm run build
4. Add to your Claude Desktop config
5. Start building tools
Going Further
This free boilerplate gets you started. The **MCP Server Boilerplate Kit** ($49) includes:
- ✅ Full TypeScript + Python dual-language templates
- ✅ Docker containerization with multi-stage builds
- ✅ CI/CD pipeline (GitHub Actions) for automated testing & deployment
- ✅ SSE (Server-Sent Events) transport for web deployments
- ✅ 15+ pre-built tool examples (file ops, API calls, database queries)
- ✅ Resource and prompt template patterns
- ✅ Error handling, logging, and retry patterns
- ✅ Testing framework with mock MCP client
- ✅ Production deployment guide (Docker, systemd, cloud)
- ✅ Claude Desktop + Cursor + Windsurf integration configs
**Get the full kit →**
Resources
- MCP Specification
- MCP TypeScript SDK
- MCP Python SDK
- Claude Desktop MCP Docs
- Glama MCP Directory