levels-fyi-mcp

MCP-Server zum Abfragen von Vergütungsdaten von levels.fyi.

Was dieser Server bietet

Servername: MyPlayground

Tools:

• calculate_addition(a: int, b: int) -> int

• get_mock_weather(city: str) -> str (simuliertes Wetter, keine echten API-Daten)

• generate_username(base_name: str, add_numbers: bool = true) -> str

Related MCP server: FastMCP Demo Server

Installation für Endbenutzer (Verwendung in Cursor)

Dieser Abschnitt ist für Benutzer gedacht, die den MCP-Server nur in Cursor installieren und ausführen möchten.

Anforderungen

• Python >=3.11

• uv

Cursor MCP-Konfiguration (empfohlen)

Verwenden Sie uv run, damit Cursor die Projektumgebung direkt nutzt.

{
  "mcpServers": {
    "user-MyPlayground": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/absolute/path/to/levels-fyi-mcp"
    }
  }
}

Verwendung starten

1. Öffnen Sie die Cursor MCP-Einstellungen und fügen Sie die obige Serverkonfiguration hinzu.

2. Stellen Sie sicher, dass cwd auf Ihren lokalen Klon dieses Repos zeigt.

3. Starten/laden Sie die MCP-Server in Cursor neu.

4. Rufen Sie Tools wie calculate_addition, get_mock_weather und generate_username auf.

Optional: direkter fastmcp-Befehl

Wenn Sie command: "fastmcp" in Cursor bevorzugen, installieren Sie es als globales Tool:

uv tool install fastmcp

Wenn Cursor fastmcp nicht finden kann, verwenden Sie die empfohlene uv run-Konfiguration von oben.

Entwickler-Setup

Dieser Abschnitt ist für Mitwirkende gedacht, die an Codeänderungen arbeiten.

Abhängigkeiten installieren

Vom Projektstammverzeichnis aus:

uv sync

Server lokal ausführen

uv run python main.py

Abhängigkeiten hinzufügen oder aktualisieren

uv add <package>
uv sync

Schnelle Umgebungsprüfung

uv run python -c "import fastmcp; print('fastmcp ok')"

Projektstruktur

.
├── main.py
├── pyproject.toml
└── README.md

Fehlerbehebung

Failed to spawn: fastmcp (os error 2)

Ursache: Cursor kann die ausführbare Datei fastmcp nicht finden.

Lösung:

1. Bevorzugen Sie die Cursor-Konfiguration mit uv run python main.py, oder

2. Installieren Sie das globale Tool mit uv tool install fastmcp und stellen Sie sicher, dass der PATH das uv-Tool-Verzeichnis enthält (üblicherweise ~/.local/bin).

Fehler bei Tool-Argumenttypen

• generate_username.add_numbers muss ein boolescher Wert (true/false) sein, keine Zahlen oder Zeichenfolgen.

Hinweise

• get_mock_weather gibt für Demos randomisierte, simulierte Daten zurück.

• Tool-Protokolle werden von main.py ausgegeben und erscheinen in der Serverausgabe.