Python MCP Server Template

A minimal template for creating a Model Context Protocol (MCP) server using the Python SDK.

:wrench: Setup

> [!TIP]

> If you want to create your own server, create a new repository using this template.

:package: Prerequisites

• uv for package management
• Python 3.13+ (`uv python install 3.13`)

:gear: Setup Python environment

Install all dependencies and activate the virtual environment

uv sync
source .venv/bin/activate

:rocket: How to use

The server can be run in multiple ways:

:robot: Visual Studio Code

The configuration to run this server in VSCode is already included in `.vscode/mcp.json`.

All you need to do is Open VS Code Copilot Edits (Agent Mode)

> [!NOTE]

> At the time of writing this, MCP is only available in Visual Studio Code Insiders version

:microscope: Development Mode

The fastest way to test and debug your server is with the MCP Inspector:

mcp dev server/main.py

or you can run your server directly

python server/main.py

:books: Documentation

For more information about the Model Context Protocol:

• MCP Python SDK
• Model Context Protocol Specification

:page_with_curl: License

This project is licensed under the MIT License