MCP Servers Template

What is MCP Servers Template?

MCP Servers Template is a starter repository for building Model Context Protocol (MCP) servers for local development. It includes three example implementations—Weather API, Calculator, and Notes—targeting developers who want to create or prototype MCP-compatible tools.

How to use MCP Servers Template?

Clone the repository, create a virtual environment (Python 3.10+ required), install dependencies with uv pip install -r requirements.txt, then run a server using mcp dev servers/<filename>.py. For VS Code integration, add the corresponding server configuration to your settings.json.

Key features of MCP Servers Template

• Weather API server with get_alerts and get_forecast tools
• Calculator server supporting basic, advanced, and trigonometric operations
• Notes server with full CRUD and keyword search functionality
• Template structure with separate server files and documentation
• Uses FastMCP library and UV package manager for fast setup
• Ready-to-use VS Code integration configuration

Use cases of MCP Servers Template

• Rapidly prototype a weather-data tool for an MCP-powered assistant
• Build a local calculator that exposes math and trig operations via MCP
• Create a persistent note‑taking application with file‑based storage
• Learn how to structure and run multiple MCP servers simultaneously
• Integrate custom MCP servers into VS Code for AI‑assisted workflows

FAQ from MCP Servers Template

What Python version is required?

Python 3.10 or higher is required. Instructions for installing the correct version on macOS, Linux, and Windows are provided in the README footnotes.

How do I run a specific server?

Use the command mcp dev servers/<filename>.py, replacing <filename> with weather, calculator, or notes.

What tools does the Weather API server provide?

It provides two tools: get_alerts to retrieve weather alerts for a US state, and get_forecast to get a weather forecast based on latitude and longitude.

How do I integrate these servers with VS Code?

Add an "mcp" entry to your settings.json with the server name, command (bash), and arguments that activate the virtual environment and run the server script, as shown in the README.

What dependencies are required besides Python?

The project requires the FastMCP library, UV package manager, and other packages listed in requirements.txt. UV is used for faster dependency installation.