# Shipshape MCP

> Shipshape MCP is a freemium MCP server for developer tools. Lint Dockerfiles and Kubernetes manifests for an A-F grade and a fix per finding. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://shipshape.bytestay.pt/integration.html
- **Repository:** https://github.com/bytestay/shipshape-mcp
- **MCP Registry name:** io.github.Bytestay/shipshape-mcp
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

Shipshape returns a grade from A to F, a score, a pass flag and every finding with its line, a fix and a reference, including Pod Security Standards checks. You can give the content or the path of a local file; Dockerfile, *.Dockerfile, Dockerfile.* and Containerfile are treated as Dockerfiles.

It runs locally over stdio with uvx and a RapidAPI or api.market key. The integration guide shows gating pull requests in GitHub Actions with line annotations by failing a step when passed is false. Each call is one request on your plan.

## Features

- **A-F grading:** Scores a file with a pass flag.
- **Fix per finding:** Each finding has a line, fix and reference.
- **Pod Security Standards:** Checks Kubernetes manifests against them.
- **Local file paths:** Reads Dockerfile or Containerfile from disk.
- **PR gating:** Can fail a CI step when a file does not pass.

## Good for

- Lint a Dockerfile before handing it over
- Gate pull requests on container security
- Review Kubernetes manifests
- Annotate lines in GitHub Actions

## Install

### Claude Code (Terminal)

```sh
claude mcp add shipshape-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-shipshape-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shipshape-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-shipshape-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shipshape-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-shipshape-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "shipshape-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bytestay-shipshape-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shipshape-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-shipshape-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shipshape-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-shipshape-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

## Tools

- `lint`: Returns the A-F grade, score, pass flag and every finding with its line, fix and reference.

## FAQ

### Which files does it recognise?

Dockerfile, *.Dockerfile, Dockerfile.* and Containerfile as Dockerfiles, plus Kubernetes manifests.

### How do I use it in CI?

POST each file and fail the step when passed is false.

### Which keys work?

RapidAPI or api.market.

### Is there a free plan?

Basic is free on RapidAPI at 15 requests a month.

### Is Shipshape MCP free?

Shipshape MCP has a free plan, with paid plans for more usage or features.

### How do I add Shipshape MCP to Claude Code?

Run this command in your terminal: claude mcp add shipshape-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-shipshape-mcp

### What are the best alternatives to Shipshape MCP?

The closest alternatives to Shipshape MCP 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/shipshape-mcp
