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