Skip to main content
Glama
AI Engineering Agent — Repository Inspector

AI Engineering Agent — Repository Inspector

by hayk79202

AI Engineering Agent — Repository Inspector

Python tests

A read-only developer tool with two MCP tools: repository inspection and log analysis. It returns JSON reports and keeps MCP access inside a configured workspace. Model-backed reasoning is a future extension; the current analysis is deterministic.

Run

python inspect_repo.py /path/to/repository --output report.json
python inspect_repo.py .
python analyze_log.py examples/sample.log

The standalone CLIs use Python 3.10+ and have no third-party dependencies. The repository tool counts source files, reports the largest files, and collects a capped list of TODO and FIXME comments. The log tool counts warning and error lines. Both are read-only.

Related MCP server: omniseek-mcp

MCP server

python -m pip install -r requirements.txt
python server.py

Configure your MCP client to launch python server.py over stdio, with ENGINEERING_ROOT set to the repository or workspace you want it to inspect. The server exposes inspect_repository(path) and analyze_log_file(path). Relative paths resolve from that root; paths outside it are rejected. The default root is the server's current working directory.

The server waits for an MCP client on standard input; it does not print a startup page.

Run python -m unittest discover -s tests -v to exercise both tools, including an in-process MCP call. GitHub Actions runs these checks on each push.

Example result

{
  "root": "/absolute/path/to/repository",
  "files_scanned": 12,
  "extensions": {".py": 8, ".md": 4},
  "largest_files": [],
  "markers": []
}

The values above illustrate the response shape; they are not a measurement of this repository.

Design

MCP client -> workspace boundary -> bounded scan -> JSON report

The repository scan is bounded to 1,000 files, 1 MiB per file, and 50 markers. Log analysis reads at most 1 MiB and returns at most 20 matching lines. Neither tool runs code or shell commands from the target repository. Future milestones include optional model summaries and workflow execution with explicit controls.

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables safe, local DevOps inspection through a JSON-lines server with schema validation, path isolation, and redaction, supporting read-only Git operations, Kubernetes YAML validation, Terraform plan summaries, and sanitized log analysis.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Exposes read-only repository scanning across architecture, security, performance and product lenses, citation verification of findings against a working tree or git revision, and HTML/SARIF/Markdown dossier rendering as MCP tools for assistants such as Claude and Cursor.
      3
      1
      Apache 2.0
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI coding agents to perform evidence-based, read-only audits of supported software projects by exposing bounded project inventory and static-analysis findings for discovery, code review, integration tracing, security, and tests. Reports are returned as Markdown or JSON directly in the tool response, with no code executed or files written.
      8
      17 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Gives a compatible coding agent read-only access to bounded local verification of changes inside a single host-chosen workspace, exposing six stdio tools that inspect capabilities, static checks, impact analysis, policy evaluation, evidence generation, and suggested tests without shell access, plugin loading, or repository upload.
      97 npm
      Apache 2.0