MCP Python Starter

by SamMorrowDrums

19 stars
157 downloads
Not rated
GitHub

About

A feature-complete Model Context Protocol (MCP) server template written in Python using FastMCP. It demonstrates all major MCP features—tools, resources, templates, and prompts—with clean, Pythonic code, serving as a jumpstart for developers building their own MCP servers.

Details

Author
SamMorrowDrums
GitHub stars
19
Downloads
157
Categories
Developer Tools

- Tools with annotations and structured data
- Dynamic tool loading at runtime
- Resource templates for personalized responses
- Progress updates for long-running tasks
- LLM sampling via tool invocation
- Code review prompt template with focus areas

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 MCP Python Starter
    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 prerequisites: Python 3.11+ and uv (recommended) or pip. Clone the repository, run uv sync (or pip install -e .), then start the server with uv run mcp-python-starter --stdio for local development or uv run mcp-python-starter --http --port 3000 for HTTP transport. VS Code integration via .vscode/mcp.json and DevContainers are included for seamless development.

Claude Desktop / Cursor

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

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

McpServers

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

MCP Python Starter

CI
Python
Ruff
License: MIT
MCP

A feature-complete Model Context Protocol (MCP) server template in Python using FastMCP. This starter demonstrates all major MCP features with clean, Pythonic code.

📚 Documentation

- Model Context Protocol
- Python SDK
- FastMCP Guide

✨ Features

| Category | Feature | Description |
|----------|---------|-------------|
| Tools | hello | Basic tool with annotations |
| | get_weather | Tool returning structured data |
| | ask_llm | Tool that invokes LLM sampling |
| | long_task | Tool with 5-second progress updates |
| | load_bonus_tool | Dynamically loads a new tool |
| Resources | info://about | Static informational resource |
| | file://example.md | File-based markdown resource |
| Templates | greeting://{name} | Personalized greeting |
| | data://items/{id} | Data lookup by ID |
| Prompts | greet | Greeting in various styles |
| | code_review | Code review with focus areas |

🚀 Quick Start

Prerequisites

- Python 3.11+
- uv (recommended) or pip

Installation

```bash

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.