get_weather
calculate
convert_currency

AI-applikation
      |
   MCP client
      |
   MCP server
      |
 Lokale tools, filer, API'er eller databaser

MCP_Test/
├── server.py
├── pyproject.toml
├── uv.lock
└── .venv/

Python
uv
Claude Desktop og/eller Cursor

uv --version

where.exe uv

C:\Users\mikc\.local\bin\uv.exe

cd C:\Users\mikc\IdeaProjects\MCP_Test

uv init --bare

uv add fastmcp

C:\Users\mikc\IdeaProjects\MCP_Test\server.py

from fastmcp import FastMCP

# MCP-serveren er den del, der udstiller capabilities til en AI-applikation.
#
# I dette eksempel er rollerne:
# - Claude Desktop eller Cursor = MCP host
# - Deres interne forbindelse til denne proces = MCP client
# - Dette Python-program = MCP server
#
# Navnet "Sample Server" vises i hosten, så brug et navn der er let at genkende.
mcp = FastMCP("Sample Server")


# @mcp.tool() gør funktionen til en MCP capability af typen tool.
#
# Et tool er en handling eller funktion, som AI'en kan kalde.
#
# Discovery:
# Hosten kan opdage tool-navn, parametre og docstring.
# Derfor er tydelige funktionsnavne, simple parametre og gode docstrings vigtige.
@mcp.tool()
def get_weather(location: str) -> str:
    """Get the current weather for a specified location."""
    # Demo-tool:
    # Dette henter ikke rigtigt vejr fra et API.
    #
    # Det viser blot, hvordan et tool kan modtage input fra hosten
    # og returnere et resultat tilbage til AI'ens kontekst.
    return f"Weather in {location}: Sunny, 72°F"


# Et lille og afgrænset tool.
#
# Designpointen er:
# Lav hellere flere små tools end én stor funktion, der prøver at gøre alt.
@mcp.tool()
def calculate(expression: str) -> float | str:
    """Calculate the result of a mathematical expression."""
    try:
        # Kun til demo:
        # eval() bør ikke bruges i rigtig produktion,
        # fordi brugeren potentielt kan sende farlig kode.
        #
        # I undervisning er det dog et simpelt eksempel på:
        # prompt -> tool call -> execution -> resultat tilbage til hosten.
        return eval(expression)
    except Exception as e:
        # Fejlhåndtering er vigtig, fordi MCP-clienten skal kunne få
        # et klart svar tilbage, hvis execution fejler.
        return f"Error calculating expression: {str(e)}"


# Endnu et lille tool med tydelige parametre.
#
# AI'en kan se parameterlisten og bruge den til at kalde funktionen korrekt.
@mcp.tool()
def convert_currency(amount: float, from_currency: str, to_currency: str) -> str:
    """Convert amount from one currency to another."""
    # Demo-data:
    # I en rigtig MCP-server kunne dette være et kald til et eksternt API,
    # en database eller et internt system.
    #
    # Det viser pointen om, at MCP-serveren kan skjule kompleksitet
    # bag et simpelt tool-interface.
    rates = {
        "USD": 1.0,
        "EUR": 0.85,
        "GBP": 0.73,
        "JPY": 110.0,
        "INR": 83.0
    }

    if from_currency not in rates or to_currency not in rates:
        return f"Unsupported currency pair: {from_currency} to {to_currency}"

    converted = amount * (rates[to_currency] / rates[from_currency])
    return f"{amount} {from_currency} = {converted:.2f} {to_currency}"


# MCP lifecycle:
#
# FastMCP håndterer:
# - initialization
# - discovery
# - execution
# - termination
#
# Når Claude Desktop eller Cursor starter serveren,
# kommunikerer de med denne proces via stdio.
#
# mcp.run() uden argumenter bruger stdio som standard.
# Det passer derfor til både Claude Desktop og Cursor.
if __name__ == "__main__":
    mcp.run()

cd C:\Users\mikc\IdeaProjects\MCP_Test
uv run server.py

Ctrl + C

C:\Users\mikc\AppData\Roaming\Claude\claude_desktop_config.json

explorer $env:APPDATA\Claude

{
  "mcpServers": {
    "sample_mcp": {
      "command": "C:\\Users\\mikc\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\mikc\\IdeaProjects\\MCP_Test",
        "run",
        "server.py"
      ]
    }
  }
}

{
  "preferences": {
    "remoteToolsDeviceName": "z4020"
  },
  "coworkUserFilesPath": "C:\\Users\\mikc\\Claude",
  "mcpServers": {
    "sample_mcp": {
      "command": "C:\\Users\\mikc\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\mikc\\IdeaProjects\\MCP_Test",
        "run",
        "server.py"
      ]
    }
  }
}

mcpServers skal ikke ligge inde i preferences.
mcpServers skal ligge på øverste niveau i JSON-filen.

1. Gem filen
2. Luk Claude Desktop helt
3. Åbn Claude Desktop igen

Brug get_weather med location Copenhagen

Brug calculate til at regne 12 * 8 + 4

Brug convert_currency til at konvertere 100 USD til EUR

C:\Users\mikc\.cursor\mcp.json

Settings / Customize
Tools & MCPs

{
  "mcpServers": {
    "sample_mcp": {
      "type": "stdio",
      "command": "C:\\Users\\mikc\\.local\\bin\\uv.exe",
      "args": [
        "--directory",
        "C:\\Users\\mikc\\IdeaProjects\\MCP_Test",
        "run",
        "server.py"
      ]
    }
  }
}

Settings / Customize
Tools & MCPs
Home MCP Servers
sample_mcp

get_weather
calculate
convert_currency

+ 
MCP Servers
sample_mcp

Brug MCP-tool get_weather med location Copenhagen

Kald sample_mcp calculate med expression "12 * 8 + 4"

Kald sample_mcp convert_currency med amount 100, from_currency USD og to_currency EUR

where.exe uv

C:\Users\mikc\.local\bin\uv.exe

"command": "C:\\Users\\mikc\\.local\\bin\\uv.exe"

No pyproject.toml found

uv init --bare

uv add fastmcp

deactivate
Remove-Item -Recurse -Force .venv
uv add fastmcp

Test-Path C:\Users\mikc\IdeaProjects\MCP_Test

Test-Path C:\Users\mikc\IdeaProjects\MCP_Test\server.py

True

Luk Claude helt og åbn igen

Slå MCP-serveren fra og til igen

Gode funktionsnavne
Simple parametre
Klare docstrings

Bruger skriver prompt
AI vurderer behov for tool
MCP-client kalder MCP-server
Python-funktionen udføres
Resultatet sendes tilbage til AI'en
AI'en formulerer svaret

get_weather
calculate
convert_currency

Read-only taskliste fra JSON-fil
Opslag i lokal SQLite-database
GitHub issue-helper
MongoDB read-only query
API-kald til rigtig vejrservice
Code review prompt

værktøjer
grænser
adgang
ansvar
fejlhåndtering
sikkerhed