MCP Servers Template

Name: MCP Servers Template
Author: gupta-ujjwal

@gupta-ujjwal

代码仓库

关于 MCP Servers Template

This repository provides a template for setting up Model Context Protocol (MCP) servers for local development.

#mcp-server-templates #mcp #server-templates

基本信息

分类

开发工具

许可证

Apache-2.0 license

运行时

python

传输方式

stdio

发布者

gupta-ujjwal

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-templates": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        "venv"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.