rf-log-mcp
rf-log-mcp
Robot Framework 결과 파일을 검사하기 위한 MCP 서버로, LLM에게 간결한 증거 뷰를 제공합니다.
기능 개요
지원 입력:
output.xml: Robot / Rebot 6.0.x / 6.1+ / 7.xoutput.json: Robot / Rebot 7.2+
제공되는 MCP 기능:
Tools
parse_resultget_viewsearch_messages
Resources
rf://runs/{run_id}/summaryrf://runs/{run_id}/tests/{test_id}
지원되는 뷰:
summaryfailure_pathstep_window
Related MCP server: RobotMCP
주요 참고 사항
이 프로젝트는 MCP stdio server입니다.
올바른 사용법: MCP 호스트가
rf-log-mcp프로세스를 시작하고, stdio를 통해 도구와 리소스를 호출합니다.
빠른 시작
1. 의존성 설치
uv sync2. 권장 MCP 구성 예시
{
"mcpServers": {
"rf-log-mcp": {
"command": "uv",
"args": [
"run",
"python",
"-m",
"rf_log_mcp"
]
}
}
}패키징 및 설치
빌드
uv build빌드 후 생성 파일:
dist/rf_log_mcp-0.1.0-py3-none-any.whldist/rf_log_mcp-0.1.0.tar.gz
wheel 설치
uv pip install dist/rf_log_mcp-0.1.0-py3-none-any.whl설치 후 바로 실행 가능:
rf-log-mcp설치된 패키지의 MCP 구성 예시
{
"mcpServers": {
"rf-log-mcp": {
"command": "rf-log-mcp",
"args": []
}
}
}Windows 명시적 경로 예시
{
"mcpServers": {
"rf-log-mcp": {
"command": "D:\\project\\rf_log_mcp\\.venv\\Scripts\\rf-log-mcp.exe",
"args": []
}
}
}일반적인 호출 흐름
1단계: 결과 파일 파싱
parse_result(path="tests/fixtures/single_failure_611.xml")일반적인 반환값:
{
"ok": true,
"run_id": 1,
"source_format": "xml"
}2단계: 요약 가져오기
get_view(run_id=1, view="summary")3단계: 실패 경로 가져오기 또는 메시지 검색
get_view(run_id=1, view="failure_path")
search_messages(run_id=1, query="timeout")환경 변수
RF_LOG_MCP_DB
기본 SQLite 데이터베이스 경로를 덮어쓰는 데 사용됩니다.
PowerShell 예시:
$env:RF_LOG_MCP_DB="D:\data\rf-log-mcp\store.sqlite3"
rf-log-mcpMCP 구성 예시:
{
"mcpServers": {
"rf-log-mcp": {
"command": "rf-log-mcp",
"args": [],
"env": {
"RF_LOG_MCP_DB": "D:\\data\\rf-log-mcp\\store.sqlite3"
}
}
}
}자주 묻는 질문
1. 왜 uv를 사용하나요?
로컬 환경의 의존성 버전이 MCP와 충돌할 수 있어 venv를 통한 격리가 필요합니다 (conda는 느리고, uv는 빠릅니다).
2. get_view / search_messages에 파일 경로를 전달할 수 있나요?
네, 가능합니다.
해당 파일이 이미 파싱된 경우, 서비스는 경로를 해당 run_id로 변환하여 조회합니다.
하지만 parse_result()가 반환하는 정수형 run_id를 우선적으로 사용하는 것을 권장합니다.
5. 어떤 경우에 이 프로젝트를 직접 사용할 수 없나요?
사용 중인 LLM 플랫폼이:
MCP를 지원하지 않거나
로컬 프로세스 시작을 지원하지 않는 경우
직접 연결할 수 없으며, 별도의 통합 계층을 구축해야 합니다.
개발 체크리스트
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