Metadata-Version: 2.5
Name: agent-checks-mcp
Version: 0.0.1
Summary: An MCP server that watches a project and serves cached lint, typecheck, and test results
Author: David Vujic
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: fastmcp
Requires-Dist: watchfiles
Description-Content-Type: text/markdown

# Agent Checks MCP

Status: WIP, not ready for usage (yet)

An MCP server that watches a project and serves cached lint, typecheck, and test results.

The Checks MCP watches a project in the background and keeps lint, typecheck, and test results up to date, so your agent gets them instantly instead of waiting for each run. Each tool takes a `project_full_path` and a `session_id`:

- `start_watching` — start watching a project; returns at once with its detected commands, while the initial lint, typecheck, and test runs warm the cache in the background.
- `detected_commands` — the lint, typecheck, and test commands for a watched session, detected on demand otherwise.
- `lint` — latest cached lint results for the session; runs lint on demand if not ready.
- `typecheck` — latest cached typecheck results for the session; runs typecheck on demand if not ready.
- `test` — latest cached test results for the session; runs the tests on demand if not ready.
- `stop_watching` — stop watching a project session; the watcher thread exits.

Each `lint`, `typecheck`, and `test` result has a `running` flag that covers only that check kind. While a run of the kind is in progress, the tool returns the previous result (or a placeholder without results) with `running: true`, instead of waiting. A failed or cancelled run returns an entry without results and a `note`, and is not retried until files change or a new session starts.

## Setup

### Add the MCP server to your harness

#### Example: using `uvx`
``` json
{
  "mcpServers": {
    "agent-checks-mcp": {
      "command": "uvx",
      "args": ["agent-checks-mcp"]
    }
  }
}
```

or install it:
``` shell
pip install agent-checks-mcp
```
