# DevReady

> DevReady is an open-source MCP server for developer tools. Read-only check that your machine meets a project's declared Node, Python and Git versions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://devready-ten.vercel.app
- **Repository:** https://github.com/evalogical-inc/devready
- **MCP Registry name:** io.github.Evalogical-Inc/devready
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

DevReady answers the "works on my machine" question before an install fails. Run it in a project folder and it reads the version pins the project declares, then compares them with what is installed and prints PASS, WARN or FAIL for each item with the fix. A check that is skipped or errors is reported as not evaluated rather than as OK.

The files it reads are .nvmrc, .node-version, .python-version, .tool-versions, the engines field in package.json and requires-python in pyproject.toml. It also compares .env.example with .env by variable name only, and never reads or prints values. It installs nothing, edits nothing, makes no network requests and sends no telemetry. Output holds only parsed versions and fixed text, so a hostile package.json cannot slip instructions to an agent, according to the README.

Over MCP it exposes a single read-only tool, check_environment, started with the devready mcp command. A Claude Code plugin adds a skill and a /devready:doctor command. For CI, devready check --format json gives a versioned report and exits 1 when a requirement is unmet. It is a zero-dependency Python 3.10+ package, MIT licensed, from Evalogical.

## Features

- **Project-aware checks:** Compares installed Node, Python, Git and npm with the versions the project itself pins.
- **Read-only by design:** Never installs, edits or deletes, makes no network calls and sends no telemetry.
- **Plain-language fixes:** Reports PASS, WARN or FAIL per item, and the explain command describes any check.
- **Versioned JSON output:** Gives a stable JSON report and exit code 1 on unmet requirements for CI.
- **Env name comparison:** Compares .env.example with .env by variable name only, never values.
- **Claude Code plugin:** Adds a skill, a /devready:doctor command and the MCP server in one install.

## Good for

- Check a fresh clone against its required Node and Python versions
- Add a preflight step to CI that fails on environment mismatches
- Have a coding agent verify the environment before builds or tests
- Help new teammates or students see exactly what to fix

## Install

### Claude Code (Terminal)

```sh
claude mcp add devready -- uvx devready-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "devready": {
      "command": "uvx",
      "args": [
        "devready-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "devready": {
      "command": "uvx",
      "args": [
        "devready-cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "devready": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "devready-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "devready": {
      "command": "uvx",
      "args": [
        "devready-cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "devready": {
      "command": "uvx",
      "args": [
        "devready-cli"
      ]
    }
  }
}
```

## Tools

- `check_environment`: Read-only check that installed tool and runtime versions meet the project's declared requirements.

## FAQ

### Does DevReady change my system?

No. It is read-only and never installs, edits or deletes anything.

### Which files does it read?

.nvmrc, .node-version, .python-version, .tool-versions, package.json engines, pyproject.toml requires-python, and .env.example compared with .env by variable name only.

### How do I install it?

Run pipx install devready-cli, or try it once with uvx --from devready-cli devready check. It needs Python 3.10 or newer.

### Can it run in CI?

Yes. devready check --format json prints a versioned report and the exit code is 1 when a requirement is unmet.

### What MCP tool does it expose?

One read-only tool named check_environment.

### Is DevReady free?

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

### How do I add DevReady to Claude Code?

Run this command in your terminal: claude mcp add devready -- uvx devready-cli

### What are the best alternatives to DevReady?

The closest alternatives to DevReady are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/devready
