Skip to main content
Glama

rf-log-mcp

Robot Framework 결과 파일을 검사하기 위한 MCP 서버로, LLM에게 간결한 증거 뷰를 제공합니다.

기능 개요

지원 입력:

  • output.xml: Robot / Rebot 6.0.x / 6.1+ / 7.x

  • output.json: Robot / Rebot 7.2+

제공되는 MCP 기능:

  • Tools

    • parse_result

    • get_view

    • search_messages

  • Resources

    • rf://runs/{run_id}/summary

    • rf://runs/{run_id}/tests/{test_id}

지원되는 뷰:

  • summary

  • failure_path

  • step_window

Related MCP server: RobotMCP

주요 참고 사항

  • 이 프로젝트는 MCP stdio server입니다.

  • 올바른 사용법: MCP 호스트가 rf-log-mcp 프로세스를 시작하고, stdio를 통해 도구와 리소스를 호출합니다.


빠른 시작

1. 의존성 설치

uv sync

2. 권장 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.whl

  • dist/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-mcp

MCP 구성 예시:

{
  "mcpServers": {
    "rf-log-mcp": {
      "command": "rf-log-mcp",
      "args": [],
      "env": {
        "RF_LOG_MCP_DB": "D:\\data\\rf-log-mcp\\store.sqlite3"
      }
    }
  }
}

자주 묻는 질문

1. 왜 uv를 사용하나요?

  1. 로컬 환경의 의존성 버전이 MCP와 충돌할 수 있어 venv를 통한 격리가 필요합니다 (conda는 느리고, uv는 빠릅니다).

2. get_view / search_messages에 파일 경로를 전달할 수 있나요?

네, 가능합니다. 해당 파일이 이미 파싱된 경우, 서비스는 경로를 해당 run_id로 변환하여 조회합니다. 하지만 parse_result()가 반환하는 정수형 run_id를 우선적으로 사용하는 것을 권장합니다.

5. 어떤 경우에 이 프로젝트를 직접 사용할 수 없나요?

사용 중인 LLM 플랫폼이:

  • MCP를 지원하지 않거나

  • 로컬 프로세스 시작을 지원하지 않는 경우

직접 연결할 수 없으며, 별도의 통합 계층을 구축해야 합니다.


개발 체크리스트

uv run ruff check .
uv run pytest

Available Tools

3 tools
get_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

    B3.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP server for log file analysis. Gives LLMs the ability to efficiently analyze large log files without loading them into context.
      7
      101
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      RobotMCP 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.
      19
      4,288 PyPI
      118
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that helps resolve Robocop static code analysis errors and warnings via LLM, providing tools to get reports and run format.
      11
      MIT