#Practical Examples

from pathlib import Path

from mcp.server import MCPServer

ROOT = Path(__file__).resolve().parent / "notes"
mcp = MCPServer("notes", instructions="Read markdown notes under ./notes only.")


def _safe(name: str) -> Path:
    path = (ROOT / name).resolve()
    if not str(path).startswith(str(ROOT.resolve())) or path.suffix != ".md":
        raise ValueError("only markdown files under notes/ are allowed")
    return path


@mcp.resource("notes://inbox")
def inbox() -> str:
    """The default inbox note."""
    path = ROOT / "inbox.md"
    return path.read_text(encoding="utf-8") if path.is_file() else "(empty inbox)"


@mcp.resource("notes://file/{name}")
def read_note(name: str) -> str:
    """Read notes/{name}.md (name without extension)."""
    return _safe(f"{name}.md").read_text(encoding="utf-8")


@mcp.prompt()
def weekly_review() -> str:
    """Start a weekly review using the inbox note."""
    return "Read notes://inbox and list three next actions."


if __name__ == "__main__":
    mcp.run()

import json
import urllib.parse
import urllib.request

from mcp.server import MCPServer

mcp = MCPServer("weather", instructions="Public forecast via Open-Meteo. No API key.")


@mcp.tool()
def current_temperature(latitude: float, longitude: float) -> str:
    """Return current temperature (°C) for a WGS84 coordinate pair."""
    query = urllib.parse.urlencode(
        {
            "latitude": latitude,
            "longitude": longitude,
            "current": "temperature_2m",
        }
    )
    url = f"https://api.open-meteo.com/v1/forecast?{query}"
    with urllib.request.urlopen(url, timeout=10) as resp:
        payload = json.loads(resp.read().decode("utf-8"))
    current = payload.get("current", {})
    value = current.get("temperature_2m")
    return f"{value} °C" if value is not None else json.dumps(payload, ensure_ascii=False)


if __name__ == "__main__":
    mcp.run()