# Repo Test Architect

> Repo Test Architect is an open-source MCP server for developer tools. Audit-first MCP server that maps a repo's existing tests and ranks where new tests add. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Linux, Windows
- **Repository:** https://github.com/repoassay/repo-test-architect
- **MCP Registry name:** io.github.RepoAssay/repo-test-architect
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says the server builds a deterministic audit graph of a codebase before any model reasons about tests. It inspects project roots, test framework signals, existing tests, source file classifications, blockers and remaining risk, all from local files, then produces rankings, test plans and verification commands from that graph.

Support is organized as language adapters with documented boundaries. The README lists adapters for JavaScript and TypeScript, PHP, Python, Ruby, Swift, Go, Rust, C#, Kotlin/JVM and Elixir, with Dart/Flutter marked experimental. Unsupported ecosystems are reported rather than hidden, and native test generation is explicitly deferred.

It is aimed at developers and teams who use AI agents for test work and want review input grounded in repository evidence. The README stresses that findings are meant as review input, not as automatic instructions to change code. It is available as a CLI, a local stdio MCP server and an invoke harness.

## Features

- **Deterministic audit graph:** Builds a repository audit from locally inspectable facts before any model is asked to reason about tests.
- **Ten language adapters:** Supports several language ecosystems and frameworks within documented boundaries, with Dart/Flutter marked experimental.
- **Ranked test candidates:** Classifies source files by likely test value and ranks candidates with generated test plans and execution hints.
- **Bounded review entrypoint:** A review command and MCP tool return a compact artifact sized for agents on large monorepos.
- **Local diagnostics:** Diagnostics are disabled by default and can be written to a bounded local file as sanitized bundles.

## Good for

- Find which untested source files are worth covering first in an existing codebase
- Give an AI coding agent a bounded, evidence-backed view of a repository's test gaps
- Get verification commands for a polyglot monorepo across several test frameworks
- Review cross-project test placement issues before changing test layout

## Install

### Claude Code (Terminal)

```sh
claude mcp add repo-test-architect -- npx -y repo-test-architect
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "repo-test-architect": {
      "command": "npx",
      "args": [
        "-y",
        "repo-test-architect"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "repo-test-architect": {
      "command": "npx",
      "args": [
        "-y",
        "repo-test-architect"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "repo-test-architect": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "repo-test-architect"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "repo-test-architect": {
      "command": "npx",
      "args": [
        "-y",
        "repo-test-architect"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "repo-test-architect": {
      "command": "npx",
      "args": [
        "-y",
        "repo-test-architect"
      ]
    }
  }
}
```

## FAQ

### How do I install it?

The README says it runs with npx --yes repo-test-architect, requires Node.js 20 or newer, and can be added to an MCP client as a stdio server using the mcp argument.

### Does it generate tests?

No. The README says native test generation is intentionally deferred and that generate_selected_test returns a structured deferred artifact.

### Does the repository source leave my machine?

The README says the client launches the server locally and source stays on the machine unless the client or another configured tool sends it elsewhere.

### Is Repo Test Architect free?

Yes. Repo Test Architect is open source, so you can use and self-host it for free.

### How do I add Repo Test Architect to Claude Code?

Run this command in your terminal: claude mcp add repo-test-architect -- npx -y repo-test-architect

### What are the best alternatives to Repo Test Architect?

The closest alternatives to Repo Test Architect are Jarroba Tools · Test audit, Trace MCP, Repograph, Ai Architect MCP Codebase and MCP Test Runner.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Jarroba Tools · Test audit](https://ai-powered.com/mcp/jarroba-tools-test-audit): Jarroba Tools · Test audit is an open-source MCP server for developer tools.
- [Trace MCP](https://ai-powered.com/mcp/trace-mcp): Trace MCP is a freemium MCP server for developer tools.
- [Repograph](https://ai-powered.com/mcp/repograph): Repograph is an open-source MCP server for developer tools.
- [Ai Architect MCP Codebase](https://ai-powered.com/mcp/ai-architect-mcp-codebase): Ai Architect MCP Codebase is an open-source MCP server for developer tools.
- [MCP Test Runner](https://ai-powered.com/mcp/mcp-test-runner): MCP Test Runner is an open-source MCP server for developer tools.
- [Test Shape MCP](https://ai-powered.com/mcp/test-shape-mcp): Test Shape MCP is an open-source MCP server for developer tools.
- [Ai Architect MCP Spec](https://ai-powered.com/mcp/ai-architect-mcp-spec): Ai Architect MCP Spec is an open-source MCP server for developer tools.
- [Repowise](https://ai-powered.com/mcp/repowise): Repowise is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/repo-test-architect
