# Showboard

Showboard is a Claude Code MCP server that turns SQL queries and spreadsheet data into browser dashboards. It renders charts, summary cards and tables on read-only data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: rohanbeingsocial
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rohanbeingsocial/showboard/tree/HEAD/packages/showboard
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/showboard

## What it does

The server runs read-only queries against databases or spreadsheets and displays visual dashboards. You can view the output in a web browser at `http://localhost:4710` or inside an adjacent terminal via `npx showboard pane`. Supported inputs include SQLite, PostgreSQL, as well as `.xlsx`, `.xlsm`, `.csv`, and `.tsv` files.

Showboard enforces read-only access by accepting only `SELECT` statements. PostgreSQL queries execute inside `READ ONLY` transactions with strict execution time and row boundaries. The server listens exclusively on `localhost` and rejects cross-site traffic.

Node.js 22.13 or later is required. Showboard also supports React 19 apps via `npm install showboard zod`, while configuration for agents is handled with `npx showboard init`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHOWBOARD_DB` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add showboard -e SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboard
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add showboard --env SHOWBOARD_DB=<SHOWBOARD_DB> -- npx -y showboard
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "showboard": {
            "command": "npx",
            "args": [
                "-y",
                "showboard"
            ],
            "env": {
                "SHOWBOARD_DB": "<SHOWBOARD_DB>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "showboard": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "showboard"
            ],
            "env": {
                "SHOWBOARD_DB": "<SHOWBOARD_DB>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHOWBOARD_DB=<SHOWBOARD_DB> showboard npx -y showboard
```
Replace <…> with your own values

## When to use it
- generate charts from local CSV and Excel spreadsheets
- visualize query results from a PostgreSQL database
- inspect SQLite tables through browser-based visual boards
- embed interactive analytical dashboards into a React 19 application

## Example prompts
- Create a chart showing monthly revenue from reports/annual.xlsx
- Build a dashboard with customer signups from shop.sqlite
- Summarize top-selling inventory items from PostgreSQL as a visual board

## Similar
- [DBHub](https://affpapa.org/en/nevibecode/mcp/dbhub.md) — MCP server · ★ 3890 repo stars
- [Faucet](https://affpapa.org/en/nevibecode/mcp/faucet.md) — MCP server · ★ 177 repo stars
- [sqlike-mcp](https://affpapa.org/en/nevibecode/mcp/sqlike-mcp.md) — MCP server · ★ 8 repo stars
- [sql-insight](https://affpapa.org/en/nevibecode/skills/sql-insight.md) — skill · ★ 4719 repo stars
- [database-scout](https://affpapa.org/en/nevibecode/skills/database-scout.md) — skill · ★ 4719 repo stars
- [drizzle](https://affpapa.org/en/nevibecode/skills/drizzle.md) — skill · 1900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
