Repo Test Architect
Audit-first MCP server that maps a repo's existing tests and ranks where new tests add
- Pricing
- Open source
- Platforms
- CLI, API, macOS
- Runs
- Locally
- Version
- 1.4.0
- Listing updated
- today
Similar MCP servers
About Repo Test Architect
Repo Test Architect is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add repo-test-architect -- npx -y repo-test-architectAdd to claude_desktop_config.json
{
"mcpServers": {
"repo-test-architect": {
"command": "npx",
"args": [
"-y",
"repo-test-architect"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"repo-test-architect": {
"command": "npx",
"args": [
"-y",
"repo-test-architect"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"repo-test-architect": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"repo-test-architect"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"repo-test-architect": {
"command": "npx",
"args": [
"-y",
"repo-test-architect"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"repo-test-architect": {
"command": "npx",
"args": [
"-y",
"repo-test-architect"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- 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
Pricing
Open source
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.