mlc_mcptester

MCP-Tester

Ein Command-Line Tool zum Testen, Debuggen und Validieren von Model Context Protocol (MCP) Servern.

English Version

Kern-Features

• Multi-Transport: Unterstützt lokale Prozesse (stdio) und Remote-Server (sse).
• Full Spec Support: Testet Tools, Resources (statisch & Templates) sowie Prompts.
• Scripting Engine: Automatisierte Test-Abläufe mit Variablen, Typ-Konvertierung und Assertions.
• Server Inspector: Analysiert Server auf Best Practices und gibt einen Quality-Score aus.
• Raw Mode: Umgeht SDK-Validierungen für tiefgreifendes Debugging.
• Profile: Einfache Verwaltung verschiedener Server in einer mcp-tester.yml.

Der "Everything" Test-Server

Im Projekt ist ein Referenz-Server (cmd/test-server) enthalten, der alle Möglichkeiten des MCP-Protokolls ausschöpft (Tools, Resources, Prompts, Logging, Progress, Output-Schemata).

Benutzung

1. Installation

Über Curl (Linux/macOS):

curl -sSL https://raw.githubusercontent.com/hmsoft0815/mlc_mcptester/main/scripts/install.sh | bash

Direkter Download: Vorkompilierte Binaries für Windows, macOS und Linux sowie .deb und .rpm Pakete finden Sie unter Releases.

Manueller Build:

task all            # Baut den Tester und Referenz-Server in den bin/ Ordner

2. Kommandos

Server Inspektion (NEU)

Analysiere einen Server auf Qualität (Metadaten, Prompts, Struktur):

./bin/mcp-tester inspect --profile local

Tools & Resources

./bin/mcp-tester list --profile local
./bin/mcp-tester call add --args '{"a": 1, "b": 2}' --profile local
./bin/mcp-tester resources read "mcp://time" --profile local

Test-Skripte (Automatisierung)

Führe komplexe Test-Szenarien aus:

./bin/mcp-tester test --script tests/03_variables_and_math.mcp --profile local

Dokumentation

• Das MCP-Handbuch - Eine 17-kapitlige, umfassende Einführung in MCP (Deutsch).
  • Kapitel 15: Automatisierung & CI/CD
• Scripting Referenz (DE) - Detaillierte Dokumentation der Test-Grammatik.
• Scripting Reference (EN) - Detailed documentation of the test grammar.

Lizenz

• Code: MIT
• Handbuch: CC BY-NC-ND 4.0

Copyright Michael Lechner - 2026-02-28