MonkeyType MCP-Server

Dies ist ein Model Context Protocol (MCP)-Server, der Zugriff auf alle Endpunkte der MonkeyType-API bietet. Der Server stellt MCP-Tools bereit, die die Interaktion von Large Language Models (LLMs) mit der MonkeyType-API ermöglichen.

Merkmale

Stellt alle MonkeyType-API-Endpunkte als MCP-Tools bereit
Kompatibel mit jedem LLM, das das Model Context Protocol unterstützt
Einfache API-Schlüssel-basierte Authentifizierung pro Tool-Aufruf
Umfassende Fehlerbehandlung
Ratenbegrenzungsbewusstsein (respektiert die Ratenbegrenzungen von MonkeyType)

Installation

Verwendung von npx (empfohlen)

Der einfachste Weg, den Server auszuführen, ist die Verwendung von npx:

npx monkeytype-mcp

Dadurch wird die neueste Version des Servers direkt heruntergeladen und ausgeführt.

Globale Installation

Sie können das Paket auch global installieren:

npm install -g monkeytype-mcp
monkeytype-mcp

Manuelle Installation

Wenn Sie das Repository lieber klonen möchten:

git clone https://github.com/CodeDreamer06/MonkeytypeMCP.git
cd MonkeytypeMCP
npm install
npm start

Verfügbare Tools

Der Server stellt die folgenden MonkeyType-API-Endpunkte als MCP-Tools bereit:

Benutzertools

check_username - Prüfen, ob ein Benutzername verfügbar ist
get_personal_bests - Ruft die persönlichen Bestleistungen des Benutzers ab
get_tags - Tags des Benutzers abrufen
get_stats - Benutzerstatistiken abrufen
get_profile - Benutzerprofil abrufen
send_forgot_password_email – E-Mail bei vergessenem Passwort senden
get_current_test_activity - Aktuelle Testaktivität abrufen
get_streak - Ruft den Streak des Benutzers ab

Tools für Testergebnisse

get_results - Erhalten Sie bis zu 1000 Testergebnisse
get_result_by_id - Ergebnis nach ID abrufen
get_last_result - Letztes Ergebnis abrufen

Öffentliche Tools

get_speed_histogram - Geschwindigkeitshistogramm abrufen
get_typing_stats - Schreibstatistiken abrufen

Bestenlisten-Tools

get_leaderboard - Bestenliste abrufen
get_leaderboard_rank - Bestenlistenrang abrufen
get_daily_leaderboard - Tägliche Bestenliste abrufen
get_weekly_xp_leaderboard – Holen Sie sich die wöchentliche XP-Bestenliste

PSA-Tools

get_psas - PSAs abrufen

Zitate-Tools

is_submission_enabled – Prüfen, ob die Angebotseinreichung aktiviert ist

Serverkonfigurationstools

get_configuration - Serverkonfiguration abrufen

So erhalten Sie Ihren MonkeyType-API-Schlüssel (ApeKey)

Um Ihren eigenen MonkeyType-API-Schlüssel (ApeKey) zu erhalten, folgen Sie diesen Schritten:

Melden Sie sich bei Ihrem MonkeyType- Konto an
Klicken Sie oben rechts auf Ihr Profilsymbol
Wählen Sie „Konto“ aus dem Dropdown-Menü
Navigieren Sie zur Registerkarte "Ape Keys"
Klicken Sie auf „Neu generieren“, um einen neuen API-Schlüssel zu erstellen
Geben Sie Ihrem Schlüssel einen Namen (z. B. „MCP-Server“)
Wählen Sie die entsprechenden Bereiche basierend auf den Endpunkten aus, auf die Sie zugreifen müssen
Klicken Sie auf „Generieren“
Kopieren Sie den generierten Schlüssel

Wichtig : Bewahren Sie Ihren API-Schlüssel sicher auf und geben Sie ihn niemals öffentlich weiter.

Verwenden des MCP-Servers mit LLMs

Um diesen Server mit einem LLM zu verwenden, müssen Sie das LLM so konfigurieren, dass dieser Server für MCP-Tool-Aufrufe verwendet wird. Sie müssen Ihren MonkeyType-API-Schlüssel (ApeKey) angeben, indem Sie die Umgebungsvariable MONKEYTYPE_API_KEY in Ihrer MCP-Serverkonfiguration festlegen.

Umgebungsvariablen

MONKEYTYPE_API_KEY : (Erforderlich) Ihr MonkeyType-API-Schlüssel. Sie finden ihn in Ihren Kontoeinstellungen auf monkeytype.com.
MONKEYTYPE_USERNAME : (Optional) Ihr MonkeyType-Benutzername oder Ihre UID. Dieser kann von bestimmten Tools (wie get_profile ) als Standard oder bei Verwendung bestimmter Schlüsselwörter verwendet werden.

Beispiel für einen Tool-Aufruf

{
  "name": "get_configuration",
  "arguments": {}
}

Integration mit LLM-Plattformen

So integrieren Sie diesen Server in LLM-Plattformen wie OpenAI, Anthropic oder andere:

Starten Sie den MCP-Server mit einer der oben genannten Installationsmethoden
Konfigurieren Sie Ihre LLM-Plattform, um diesen Server als MCP-Tool-Anbieter zu verwenden
Übergeben Sie das Standarddio des Servers als Kommunikationskanal

IDE-Integration

MCP-Konfiguration

Um MonkeyType MCP zu Ihrer IDE hinzuzufügen, fügen Sie Folgendes zur MCP-Konfigurationsdatei Ihrer IDE hinzu:

{
  "mcpServers": {
    "monkeytype": {
      "command": "sh",
      "args": ["-c", "cd $(mktemp -d) && npm install monkeytype-mcp && npx monkeytype-mcp"],
      "env": {
        "MONKEYTYPE_API_KEY": "YOUR_APE_KEY_HERE"
      }
    }
  }
}

Speicherorte der Konfigurationsdateien:

Cursor: ~/.cursor/mcp.json
Windsurfen: ~/.codeium/windsurf/mcp_config.json
Cline: ~/.cline/mcp_config.json
Claude: ~/.claude/mcp_config.json

VS Code-Integration

So verwenden Sie diesen MCP-Server in VS Code:

Öffnen Sie die VS Code-Einstellungen
Suche nach „MCP-Server“
Fügen Sie einen neuen MCP-Server mit der folgenden Konfiguration hinzu:
- Name: MonkeyType MCP
- Befehl: npx monkeytype-mcp
- Typ: Standard-Eingabe/Ausgabe (stdio)

Verfügbare Tools

Der Server stellt die folgenden MonkeyType-API-Endpunkte als MCP-Tools bereit:

Benutzertools

check_username - Prüfen, ob ein Benutzername verfügbar ist
get_personal_bests - Ruft die persönlichen Bestleistungen des Benutzers ab
get_tags - Tags des Benutzers abrufen
get_stats - Benutzerstatistiken abrufen
get_profile - Benutzerprofil abrufen
send_forgot_password_email – E-Mail bei vergessenem Passwort senden
get_current_test_activity - Aktuelle Testaktivität abrufen
get_streak - Ruft den Streak des Benutzers ab

`get_profile`

Ruft das öffentliche Profil eines Benutzers ab.

Parameter:

uidOrName (Zeichenfolge, optional): Die UID oder der Benutzername des Benutzers, dessen Profil abgerufen werden soll.
- Wenn Sie einen bestimmten Benutzernamen oder eine bestimmte UID angeben, wird das Profil dieses Benutzers abgerufen.
- Sie können Schlüsselwörter wie „me“, „self“, „current“ oder „my“ verwenden. Wenn eines dieser Schlüsselwörter verwendet wird, verwendet das Tool die Umgebungsvariable MONKEYTYPE_USERNAME (sofern festgelegt).
- Wenn dieser Parameter vollständig weggelassen wird, versucht das Tool auch, die Umgebungsvariable MONKEYTYPE_USERNAME zu verwenden (sofern festgelegt).
- Wenn der Parameter uidOrName weggelassen wird (oder ein Schlüsselwort verwendet wird) und die Umgebungsvariable MONKEYTYPE_USERNAME nicht festgelegt ist, tritt ein Fehler auf.

Tools für Testergebnisse

get_results - Erhalten Sie bis zu 1000 Testergebnisse
get_result_by_id - Ergebnis nach ID abrufen
get_last_result - Letztes Ergebnis abrufen

Öffentliche Tools

get_speed_histogram - Geschwindigkeitshistogramm abrufen
get_typing_stats - Schreibstatistiken abrufen

Bestenlisten-Tools

get_leaderboard - Bestenliste abrufen
get_leaderboard_rank - Bestenlistenrang abrufen
get_daily_leaderboard - Tägliche Bestenliste abrufen
get_weekly_xp_leaderboard – Holen Sie sich die wöchentliche XP-Bestenliste

PSA-Tools

get_psas - PSAs abrufen

Zitate-Tools

is_submission_enabled – Prüfen, ob die Angebotseinreichung aktiviert ist

Serverkonfigurationstools

get_configuration - Serverkonfiguration abrufen

Veröffentlichen

Wenn Sie Änderungen an diesem Server vornehmen und Ihre eigene Version veröffentlichen möchten:

npm login
npm publish

GitHub-Repository

Dieses Projekt wird auf GitHub unter https://github.com/CodeDreamer06/MonkeytypeMCP gehostet.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE.

Danksagung

MonkeyType für die Bereitstellung der API
Model Context Protocol (MCP) für die Serverarchitektur

Haftungsausschluss

Dieses Projekt ist nicht offiziell mit MonkeyType verbunden. Die Nutzung erfolgt auf eigene Gefahr und stellt sicher, dass Sie die Nutzungsbedingungen und API-Ratenbegrenzungen von MonkeyType einhalten.

Integrations