# unripe

> unripe is an open-source MCP server for security. Check how long ago a package version was published before an agent adds it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/texwow/unripe
- **MCP Registry name:** io.github.texWoW/unripe
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Many supply-chain compromises are spotted and pulled within hours, so a short cooldown skips them. unripe reads lockfiles and fails any dependency version published more recently than a minimum age, three days by default. The README replays real incidents: the September 2025 npm compromise of debug and chalk, and the August 2026 npm worm that hit 444 packages.

It covers about two dozen ecosystems including npm, PyPI, Cargo, Go, Composer, RubyGems, NuGet, Gradle, Dart, CocoaPods, Swift, Terraform, Conan, R, Elixir, Nix, Bazel and vcpkg, plus GitHub Actions in workflows. When a version is too new, it names the newest older version that would pass, and an explain command lists recent releases. Rules can differ by ecosystem or package pattern, with dated allowances that record a reason.

It runs in CI, as a pre-commit hook, from Python and as a stdio MCP server so coding agents check age first. It needs Python 3.11 or newer and has no dependencies. The README states it does not protect against everything a cooldown cannot.

## Features

- **Lockfile age check:** Fails versions published more recently than a set minimum age.
- **20+ ecosystems:** One policy across npm, PyPI, Cargo, Go and many more.
- **Passing version hint:** Names the newest older version that is old enough.
- **Per-package rules:** Different ages by ecosystem or package pattern.
- **Dated allowances:** Let a needed version through until a date, with a reason.
- **PR-only mode:** Report only versions a branch adds.

## Good for

- Stop an agent from adding a brand-new package version
- Add a cooldown policy to CI across several ecosystems
- Review only versions a pull request adds
- Replay a past incident to see whether a cooldown would have helped

## Install

### Claude Code (Terminal)

```sh
claude mcp add unripe -- uvx unripe
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "unripe": {
      "command": "uvx",
      "args": [
        "unripe"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unripe": {
      "command": "uvx",
      "args": [
        "unripe"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "unripe": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "unripe"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unripe": {
      "command": "uvx",
      "args": [
        "unripe"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "unripe": {
      "command": "uvx",
      "args": [
        "unripe"
      ]
    }
  }
}
```

## FAQ

### What is the default minimum age?

Three days.

### What does it need to run?

Python 3.11 or newer; it has no dependencies.

### How can I check a package before adding it?

Use unripe explain with the ecosystem and package name.

### Does it cover GitHub Actions?

Yes, with the --workflows option.

### Is unripe free?

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

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

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

### What are the best alternatives to unripe?

The closest alternatives to unripe are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/unripe-2
