Python MCP Server Template

by FidelusAleksander

3 stars
271 downloads
Not rated
GitHub

About

A minimal template for creating a Model Context Protocol (MCP) server using the Python SDK. It provides a starting point for developers building MCP‑compatible servers with Python.

Details

Author
FidelusAleksander
GitHub stars
3
Downloads
271
Categories
Developer Tools, AI

- Ready‑to‑use MCP server skeleton in Python
- Uses UV package manager and Python 3.13+
- Includes VS Code launch configuration for Copilot Edits
- Supports MCP Inspector for development testing
- Provides a template to create your own repository on GitHub
- Licensed under MIT

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Python MCP Server Template
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with uv sync, activate the virtual environment, then run the server with mcp dev server/main.py or python server/main.py. For Visual Studio Code Insiders, use the included .vscode/mcp.json configuration.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "python mcp server template": {
            "python-mcp-server-template": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "python-mcp-server-template": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

Python MCP Server Template

Python 3.13+
License: MIT

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.