# Platter

> Platter is an MCP server for developer tools. Let a browser agent read, edit, search and run commands on a machine, with restrictions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Platforms:** CLI, Linux, macOS, self-hosted
- **Repository:** https://github.com/hadriangateway/platter
- **MCP Registry name:** io.github.hadriangateway/platter
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Platter turns a computer into an MCP endpoint, mainly so browser-based agents such as Hadrian can control it. It ships as standalone Bun-compiled binaries for Linux and macOS (x64 and arm64), as mcpb bundles and as a Docker image, and speaks stdio or Streamable HTTP, on port 3100 by default.

The tool set is read, write, edit, bash, glob, grep and js. Edit tolerates smart quotes, dashes and Unicode whitespace and returns a unified diff. Grep uses ripgrep, which must be installed. The js tool evaluates code in a persistent Node.js vm context and can load packages from unpkg, but the README says it is not a security sandbox.

Several flags narrow what a client can do: --tools registers only selected tools, --allow-path limits the file tools to given directories with symlinks resolved via realpath, and --allow-command takes anchored regexes for bash. A just-bash sandbox option applies to bash only. HTTP mode defaults to OAuth and also supports bearer tokens, external JWKS or OIDC with per-tool scopes, TLS and a Linux tray.

## Features

- **Seven machine tools:** Read, write, edit, bash, glob, grep and js over stdio or HTTP.
- **Tool selection:** --tools hides unregistered tools completely from clients.
- **Path restriction:** --allow-path confines file tools to chosen directory trees, resolving symlinks.
- **Command allowlist:** --allow-command accepts anchored regexes so only matching bash commands run.
- **HTTP authentication:** OAuth by default, plus bearer, JWKS/OIDC with tool-scoped grants, or none.
- **Process limits:** Bash timeouts, a max process count per session and an optional session cap.

## Good for

- Give a browser agent a working directory to read and edit
- Run a read-only code-search server with only read, glob and grep
- Limit an agent to git and npm commands inside one project
- Serve a machine to a remote agent over authenticated HTTP

## Install

### Claude Code (Terminal)

```sh
claude mcp add platter -- docker run -i --rm ghcr.io/hadriangateway/platter:2.1.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "platter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hadriangateway/platter:2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hadriangateway/platter:2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "platter": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hadriangateway/platter:2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hadriangateway/platter:2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platter": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/hadriangateway/platter:2.1.0"
      ]
    }
  }
}
```

## Tools

- `read`: Reads file contents with pagination and detects image files.
- `write`: Creates or overwrites files, creating parent directories.
- `edit`: Find-and-replace with exact or fuzzy matching, returning a unified diff.
- `bash`: Executes shell commands with timeouts.
- `glob`: Matches file patterns and returns up to 500 paths.
- `grep`: Searches file contents using ripgrep.
- `js`: Evaluates JavaScript or TypeScript in a persistent Node.js vm context.

## FAQ

### What transports does it support?

stdio and Streamable HTTP; HTTP binds to 127.0.0.1:3100 by default.

### Is the js tool sandboxed?

No. The README says it is not a security sandbox and the sandbox flag applies to bash only.

### Can I make it read-only?

Yes, run it with --tools read,glob,grep.

### What does grep need?

ripgrep (rg) must be installed.

### How can I run it?

Download a release binary, use the ghcr.io/hadriangateway/platter Docker image, or build from source with Bun.

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

Run this command in your terminal: claude mcp add platter -- docker run -i --rm ghcr.io/hadriangateway/platter:2.1.0

### What are the best alternatives to Platter?

The closest alternatives to Platter 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/platter
