@m00nsolutions/mcp-server

Agentisches Testmanagement über MCP. Dieser Server lässt einen KI-Assistenten die Arbeit erledigen, statt nur darüber zu lesen: Testfälle verfassen, manuelle Testausführungen planen und befüllen, Automatisierung zurück mit den abgedeckten Fällen verknüpfen, Releases schnüren und die Projektgesundheit in M00N Report ablesen – einer KI-nativen Testmanagement-Plattform.

Welche Installation brauchst du?

Wenn du dich nicht von claude.ai oder claude.com aus verbindest, verwende dieses Paket mit einem MCP-Schlüssel. Um genau das geht es im Rest dieser README. Für den Connector siehe die Connector-Anleitung.

Related MCP server: @testneo/mcp-server

Voraussetzungen

Node.js 20 oder neuer und ein MCP-fähiger Client.

Installation

Es ist kein Installationsschritt erforderlich. Der Client startet das Paket mit npx, so wie unten konfiguriert.

Zum Festsetzen einer Version in einer gemeinsamen Umgebung oder in CI hängst du eine Version an den Paketnamen in args an, z. B. ["-y", "@m00nsolutions/mcp-server@<version>"]. Mit npm view @m00nsolutions/mcp-server versions findest du heraus, was veröffentlicht ist. Absichtlich wird hier nur ein Platzhalter gezeigt: Ein konkretes Beispiel wäre beim nächsten Release veraltet, und ein veraltetes Beispiel würde empfehlen, dich auf eine Version festzulegen, die die aktuellen Korrekturen nicht mehr enthält.

Schnellstart

1. MCP-Schlüssel erhalten

Öffne in M00N Report Settings -> MCP Keys und lege einen Schlüssel an. Er beginnt mit m00n_mcp_, gefolgt von 48 Hexadezimalzeichen. Das ist nicht die Zugangsdaten, die die Test-Reporter verwenden; deren Schlüssel beginnt mit m00n_ und wird hier abgelehnt.

Ein MCP-Schlüssel besitzt genau die Berechtigungen des Kontos, zu dem er gehört, niemals mehr, und kann weiter eingeschränkt werden. Die Einschränkung entfernt Werkzeuge aus der Liste, die der Client sieht. Eine kürzere Werkzeugliste als erwartet ist also eine Umfangsentscheidung, kein Fehler.

Der Schlüssel gehört in die MCP-Client-Konfiguration auf deinem Rechner. Lege ihn nicht in einer Workspace-Datei ab, die in einem Repository liegt.

2. Client verbinden

Claude Code, eine Zeile:

claude mcp add m00n --env M00N_API_URL=https://m00nreport.com --env M00N_API_KEY=m00n_mcp_... -- npx -y @m00nsolutions/mcp-server

Jeder andere Client verwendet denselben JSON-Block:

{
  "mcpServers": {
    "m00n": {
      "command": "npx",
      "args": ["-y", "@m00nsolutions/mcp-server"],
      "env": {
        "M00N_API_URL": "https://m00nreport.com",
        "M00N_API_KEY": "m00n_mcp_your_key_here"
      }
    }
  }
}

Dahin gehört der Block:

Für eine selbst gehostete Instanz zeigst du mit M00N_API_URL auf deine eigene Root-Origin, ohne /api-Suffix. Ein abschließender Schrägstrich wird dir entfernt.

3. Verbindung bestätigen

Startetten Client neu und frag ihn dann:

Liste meine Projekte in M00N Report auf

Eine Liste deiner Projekte bedeutet: Der Server ist verbunden und der Schlüssel ist gültig. Ein Fehler oder die Antwort des Assistenten, kein solches Werkzeug zu haben, bedeutet das Gegenteil; siehe Fehlerbehebung.

Werkzeuge

Acht Bereiche. Die vollständige Liste mit Argumenten findest du bei /documentation/mcp/tools, direkt neben dem Code. Der Server lädt seine Liste beim Start von deiner Instanz. Was dein Client also sieht, entspricht dem, was deine Instanz beim Verbindungsaufbau unterstützte.

Eine Ausführung ist ein manueller Testlauf: Zuständige, Umgebung, Termine und Ergebnisse pro Schritt werden als Schnappschuss jedes Testfalls zum Zeitpunkt des Hinzufügens festgehalten.

Wie viele Werkzeuge dein Schlüssel sehen kann, legt deine Instanz fest:

curl -s -H "X-MCP-Key: $M00N_API_KEY" "$M00N_API_URL/api/mcp/tools" | jq .count

Das ergab auf m00nreport.com mit uneingeschränktem Schlüssel beim Stand von 2026–08–22 eine 57.

Prompts

Geführte mehrstufige Workflows, die der Client namentlich anbieten kann. Jeder nimmt ein einzelnes optionales project-Argument entgegen – einen Namen oder eine UUID. Wenn du es weglässt, wählt der Server das Projekt aus, sofern nur eines zur Auswahl steht.

Ressourcen

Schreibgeschützte Ansichten, die der Client ohne Tool-Aufruf abrufen kann: alle Projekte, Projektgesundheitsübersicht, Bericht zu flakigen Tests, aktuell fehlschlagende Tests, Ordnerübersicht, Launch-Bericht, TestfallberichteInhalt, Release-Bericht.

Konfiguration

Zwei Booleanen sind bei true, 1 oder yes aktiv; Egal in welchen Groß-/Kleinschatungen. Jeder andere Wert bleibt haben false und 0 – deaktiviert sie.

Setge auf die ersten beiden Variablen beide oder keine von beiden. Nur eine einzige zu setzen, gilt als Konfigurationsfehler und wird zurückgewiesen: Ein halb konfigurierter Server, der trotzdem start, ist schwerer zu diagnostizieren als einer, der nicht startet.

The Base-URL heißt hier M00N_API_URL; Test-Reporter nennen dieselbe URL M00N_SERVER_URL. Alle sechs Pakete lesen M00N_API_KEY, aber deren Schlüssel ist ein Projekt-API-Schlüssel, keinMCP-Schlüssel. Und daher kann eine exportiert shell variable nicht für beides dienen.

Ausführung ohne Schlüssel

Wenn der Server weder mit M00N_API_URL noch mit M00N_API_KEY gestartet wird, läuft er im Vorschaumodus: Er listet seine Tools, Prompts und Ressourcen aus einem eingebetteten Schnappschuss auf und lehnt jeden Aufruf mit einem Hinweis ab, was gesetzt werden muss. Es wird nichts versendet, weil es kein Ziel gibt, an das gesendet werden könnte.

Das ist es, was einem Inspector, einem Client oder einem Verzeichnis erlaub, die Werkzeugoberfläche anzuzeigen, noch bevor sich jemand angemeldet hat. Dabei handelt es sich um eine Beschreibung des Servers, nie um einen funktionierenden Server. Die Einträge stammen also aus der Snapshot, nicht aus deiner Instanz: Ein eingeschränktener Schlüssel sieht normalerweise weniger Werkzeuge, als der Schnappschuss zeigt.

Maintainer aktualisieren den Schnappschuss mit npm run snapshot:refresh gegen einen uneingeschränkten Schlüssel.

Selbst gehostet

Richte M00N_API_URL auf deine eigene Instanz aus und stelle den MCP-Schlüssel dieser Instanz aus. Alles andere ist identisch – wichtig, v. a. wenn du selbst hostest, weil Testeriedaten dein Netzwerk nicht verlassen dürfen.

Bei einem selbst "unterschriebenen" Zertifikat fügst du in denselben env-Block "M00N_INSECURE_SSL": "true" ein. Ausführliche Hinweise: /documentation/mcp/self-hosted.

What goes over

Per HTTPS an M00N_API_URL: die Tool-Calls deines Assistenten und ihre Argumente. Der Server ist nur einProxy zu deiner Instanz und speichert selbst nichts.

Jeder Tool-Aufruf wird in a MCP-Audit-Protokoll mit einer UI in the app geschrieben, und individually per-Schlüssel-Limit. Der Schlüssel wird nie in dieses Protokoll oder auf stderr geschrieben. Unter M00N_DEBUG werden die Argumente der verwendeten Tool-Aufruf auf stderr ausgegeben; be shafts diese Ausgabe also wie die Daten selbst.

Fehlerbehebung

Der Server protokolliert auf stderr, mit oder ohne M00N_DEBUG; die meisten Clients zeigen diese Ausgabe in ihrem MCP-Panel. Setzen Sie M00N_DEBUG auf true, um jede Anfrage samt Argumenten zu protokollieren.

Bekannte Einschränkungen

• Die Tool-Liste wird nur einmal beim Start gelesen. Ändern Sie den Geltungsbereich eines Schlüssels oder aktualisieren Sie die Instanz, behält der Client die alte Liste, bis Sie den Client neu starten.

• GET /api/health muss erreichbar sein, wenn es konfiguriert ist. Es wird vor allem anderen geprüft; ein Fehler stoppt den Server. Ein Proxy, der nur /api/mcp/* weiterleitet, zeigt daher keine Tools an, auch wenn jedes Tool funktionieren würde.

• Ein Schlüssel, der auf null Tools beschränkt ist, startet nicht. Der Server beendet sich, statt sich mit einer leeren Liste zu verbinden. Das ist der konfigurierte Weg; ohne Anmeldedaten startet er stattdessen im Vorschaumodus.

• Prompts und Ressourcen sind optional. Wenn ihre Auflistungen fehlschlagen, startet der Server trotzdem, wobei der Fehlergrund auf stderr ausgegeben wird; der Client sieht für die gesamte Sitzung nichts von ihnen.

• Weiterleitungen werden abgelehnt und nicht verfolgt. Der Schlüssel liegt in einem benutzerdefinierten Header, und Redirect-Follower entfernen nur die von ihnen erkannten Auth-Header. Einer Weiterleitung zu folgen würde den Schlüssel an den Host übergeben, der als Nächstes antwortet. Eine Weiterleitung wird mit der Adresse gemeldet, auf die sie zeigte.

• Nur stdio. Für HTTP-Transport verwenden Sie den gehosteten Connector.

Support

• Paket auf npm

• Dokumentation

• Probleme melden

• Community-Discord

Lizenz

MIT-Lizenz. Siehe LICENSE.