# Evergreen

> Evergreen is an open-source MCP server for developer tools. Find end-of-life runtimes, packages and Actions in a repo, with file, line and source. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://arminazimi.github.io/evergreen/
- **Repository:** https://github.com/arminazimi/evergreen
- **MCP Registry name:** io.github.arminazimi/evergreen
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

Evergreen scans a repository for runtimes, packages and CI references that have reached end of life or been deprecated. Each finding names the exact file and line, an authoritative source, a replacement and migration steps. A sample run on a deliberately outdated project flags an unsupported actions/checkout runtime in a workflow and Node.js 18 and 19 in package.json.

Detectors read container base images, .NET project files, go.mod, GitHub Actions workflows, CMake and Conan files, CI runner images and JVM build files, among others. Values it cannot classify, such as variables, latest tags and floating versions, are listed as unclassified rather than guessed. Scans are deterministic, run offline and need no account.

The same engine ships as an npm CLI, a local stdio MCP server started with evergreen-mcp, a GitHub Action that can emit SARIF for code scanning, a GitLab component and an Agent Skill. Agents can check a package URL such as pkg:npm/left-pad@1.0.0 before adding a dependency, then use migration packets and plans to work through findings. It needs Node.js 22 or newer.

## Features

- **Exact-line findings:** Reports the file and line for each end-of-life or deprecated item.
- **Evidence per finding:** Every result carries a source, a replacement and migration steps.
- **Pre-install check:** Check a package URL before an agent adds the dependency.
- **Offline scans:** Deterministic scans run locally with no account.
- **CI integration:** GitHub Action with SARIF output and a GitLab CI component.
- **Migration packets:** Structured context and plans for agents to migrate one finding at a time.

## Good for

- Audit a repository for end-of-life Node.js, Go or JDK versions
- Stop an agent from adding a deprecated package
- Gate pull requests on lifecycle severity
- Hand an agent the facts it needs to migrate off a retired GitHub Action

## Install

### Claude Code (Terminal)

```sh
claude mcp add evergreen -- npx -y evergreen-deprecation
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "evergreen": {
      "command": "npx",
      "args": [
        "-y",
        "evergreen-deprecation"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "evergreen": {
      "command": "npx",
      "args": [
        "-y",
        "evergreen-deprecation"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "evergreen": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "evergreen-deprecation"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "evergreen": {
      "command": "npx",
      "args": [
        "-y",
        "evergreen-deprecation"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "evergreen": {
      "command": "npx",
      "args": [
        "-y",
        "evergreen-deprecation"
      ]
    }
  }
}
```

## FAQ

### Does it need network access or an account?

No. The README says scans are offline and need no account; one command uses the network, described on the privacy page.

### What does it scan?

Runtimes, packages and GitHub Actions, plus container images, .NET, Go, C and C++, CI runner images and JVM projects.

### What happens with versions it cannot read?

They are listed as unclassified instead of being guessed.

### What do I need to run it?

Node.js 22 or newer.

### Is Evergreen free?

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

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

Run this command in your terminal: claude mcp add evergreen -- npx -y evergreen-deprecation

### What are the best alternatives to Evergreen?

The closest alternatives to Evergreen 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/evergreen
