# PlatypusDB

> PlatypusDB is an open-source MCP server for databases. Gives MCP clients access to your PlatypusDB database connections, scoped per agent. It runs locally on your machine and is started by your AI client.

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

## About

PlatypusDB is a desktop SQL client written with a Rust core and a Tauri 2 and React interface, and this server exposes its saved connections to agents such as Claude Code, Codex and Cursor. Each agent gets one of three access levels: none, read only (the default) or read and write, and any change an agent wants to run opens a confirmation dialog in the app first.

The registry entry points to a Windows MCPB bundle of release 0.6.1. Behind it is a client for PostgreSQL, MySQL, SQL Server, Oracle, SQLite, DuckDB, ClickHouse, MongoDB, Redis, Snowflake, BigQuery and more, with a results grid for millions of rows, query plans, table design and schema comparison.

Production connections are marked with a red frame, open in manual commit and leave an undo script after edits. The project is AGPL-3.0, collects no telemetry and needs no account.

## Features

- **Per-agent access:** Choose none, read only or read and write for each agent.
- **Approval for changes:** Write statements wait for your OK in a dialog inside the app.
- **Many database engines:** One client covers about twenty database systems.
- **Production safeguards:** Production connections get a visual marker, manual commit and undo scripts.
- **Companion CLI:** A platypus command line tool works on the same connections.

## Good for

- Let an agent query a staging database read-only
- Review an agent's proposed SQL change before it runs
- Explore several databases from one client
- Explain a slow query with a visual plan

## Install

### Claude Code (Terminal)

```sh
claude mcp add platypus-db -- npx -y https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "platypus-db": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platypus-db": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "platypus-db": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platypus-db": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "platypus-db": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb"
      ]
    }
  }
}
```

## FAQ

### What is the default access for an agent?

Read only.

### Does an agent's change run automatically?

No. A change an agent wants to run opens a dialog in the app first.

### Is an account needed?

No. The site says it is free and open source with no account, and the README lists AGPL-3.0.

### Which systems does it run on?

Windows, macOS and Linux; the registry package is a Windows MCPB bundle.

### Is PlatypusDB free?

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

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

Run this command in your terminal: claude mcp add platypus-db -- npx -y https://github.com/platypus-labs/platypus-db/releases/download/v0.6.2/platypus-db-0.6.2-windows-x64.mcpb

### What are the best alternatives to PlatypusDB?

The closest alternatives to PlatypusDB 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/platypusdb
