rf-log-mcp
rf-log-mcp
Ein MCP-Server zur Überprüfung von Robot Framework-Ergebnisdateien, der LLMs eine prägnante Ansicht der Beweise bietet.
Funktionsübersicht
Unterstützte Eingaben:
output.xml: Robot / Rebot 6.0.x / 6.1+ / 7.xoutput.json: Robot / Rebot 7.2+
Bereitgestellte MCP-Funktionen:
Tools
parse_resultget_viewsearch_messages
Ressourcen
rf://runs/{run_id}/summaryrf://runs/{run_id}/tests/{test_id}
Unterstützte Ansichten:
summaryfailure_pathstep_window
Related MCP server: RobotMCP
Wichtige Hinweise
Dieses Projekt ist ein MCP stdio server.
Der korrekte Weg ist: Der MCP-Host startet den
rf-log-mcp-Prozess und ruft dann Tools und Ressourcen über stdio auf.
Schnellstart
1. Abhängigkeiten installieren
uv sync2. Empfohlenes MCP-Konfigurationsbeispiel
{
"mcpServers": {
"rf-log-mcp": {
"command": "uv",
"args": [
"run",
"python",
"-m",
"rf_log_mcp"
]
}
}
}Paketierung und Installation
Build
uv buildNach dem Build werden folgende Dateien generiert:
dist/rf_log_mcp-0.1.0-py3-none-any.whldist/rf_log_mcp-0.1.0.tar.gz
Wheel installieren
uv pip install dist/rf_log_mcp-0.1.0-py3-none-any.whlNach der Installation kann es direkt gestartet werden:
rf-log-mcpMCP-Konfigurationsbeispiel für installierte Pakete
{
"mcpServers": {
"rf-log-mcp": {
"command": "rf-log-mcp",
"args": []
}
}
}Beispiel für explizite Pfade unter Windows
{
"mcpServers": {
"rf-log-mcp": {
"command": "D:\\project\\rf_log_mcp\\.venv\\Scripts\\rf-log-mcp.exe",
"args": []
}
}
}Typischer Ablauf
Schritt 1: Ergebnisdatei parsen
parse_result(path="tests/fixtures/single_failure_611.xml")Typische Rückgabe:
{
"ok": true,
"run_id": 1,
"source_format": "xml"
}Schritt 2: Zusammenfassung abrufen
get_view(run_id=1, view="summary")Schritt 3: Fehlerpfad abrufen oder Nachrichten durchsuchen
get_view(run_id=1, view="failure_path")
search_messages(run_id=1, query="timeout")Umgebungsvariablen
RF_LOG_MCP_DB
Wird verwendet, um den Standardpfad der SQLite-Datenbank zu überschreiben.
PowerShell-Beispiel:
$env:RF_LOG_MCP_DB="D:\data\rf-log-mcp\store.sqlite3"
rf-log-mcpMCP-Konfigurationsbeispiel:
{
"mcpServers": {
"rf-log-mcp": {
"command": "rf-log-mcp",
"args": [],
"env": {
"RF_LOG_MCP_DB": "D:\\data\\rf-log-mcp\\store.sqlite3"
}
}
}
}Häufig gestellte Fragen
1. Warum wird uv verwendet?
Die Abhängigkeitsversionen der lokalen Umgebung können mit denen von MCP in Konflikt stehen, daher ist ein venv zur Isolierung erforderlich (conda ist zu langsam, uv ist schnell).
2. Können get_view / search_messages Dateipfade entgegennehmen?
Ja.
Wenn die Datei bereits geparst wurde, konvertiert der Dienst den Pfad in die entsprechende run_id und führt dann die Abfrage durch.
Es wird jedoch weiterhin empfohlen, vorzugsweise die von parse_result() zurückgegebene Ganzzahl run_id zu verwenden.
5. In welchen Fällen kann dieses Projekt nicht direkt verwendet werden?
Wenn Ihre LLM-Plattform:
MCP nicht unterstützt
oder das Starten lokaler Prozesse nicht unterstützt
Dann kann keine direkte Anbindung erfolgen und es ist eine zusätzliche Integrationsschicht erforderlich.
Entwicklungsprüfung
uv run ruff check .
uv run pytestAvailable Tools
3 toolsget_viewC
Get one supported view using a numeric run id or an already-parsed file path.
Inputs: run_id (required), view (required), selector, cursor, +1 more. Returns: object
parse_resultB
Parse a Robot Framework output.xml or RF 7.2+ output.json file and index it.
Inputs: path (required), force_rebuild. Returns: object
search_messagesC
Search indexed messages using a numeric run id or an already-parsed file path.
Inputs: run_id (required), query (required), level, limit, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get_view retrieves a specific view, parse_result processes and indexes files, and search_messages queries indexed messages. There is no overlap in functionality, and the descriptions clearly differentiate their roles, making misselection unlikely.
All tool names follow a consistent verb_noun pattern (get_view, parse_result, search_messages) with clear, descriptive verbs and nouns. The naming is uniform throughout, using snake_case consistently without any deviations or mixed conventions.
With only 3 tools, the set feels thin for a Robot Framework log management server, as it might lack operations like updating or deleting parsed data. However, the tools cover core parsing and querying functions, making it borderline appropriate but potentially limited in scope.
The tools provide basic parsing and search capabilities, but there are notable gaps: no update or delete operations for indexed data, and no tools for managing multiple runs or views beyond retrieval. This could lead to dead ends in workflows requiring data modification or broader management.
Maintenance
Related MCP Connectors
MCP server exposing the Backtest360 engine API as tools for AI agents.
MCP server for Pentest-Tools.com: run scans, manage findings and reports via your preffered LLM.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for log file analysis. Gives LLMs the ability to efficiently analyze large log files without loading them into context.7101MIT
- AlicenseBqualityBmaintenanceRobotMCP is a comprehensive Model Context Protocol (MCP) server that bridges the gap between human language and Robot Framework automation. It enables AI agents to understand test intentions, execute steps interactively, and generate complete test suites from successful executions.194,288 PyPI118Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server that helps resolve Robocop static code analysis errors and warnings via LLM, providing tools to get reports and run format.11MIT
- AlicenseNot gradedqualityCmaintenanceA local MCP server that parses Robot Framework output.xml files, scores and groups failures, and exposes structured triage data to Claude Desktop and Claude Code.MIT