mcp-dashboards

mcp
Security Audit
Fail
Health Pass
  • License — License: NOASSERTION
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 14 GitHub stars
Code Fail
  • process.env — Environment variable access in index.ts
  • process.env — Environment variable access in preview-server.ts
  • os.homedir — User home directory access in server.ts
  • process.env — Environment variable access in server.ts
  • network request — Outbound network request in server.ts
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is an MCP server that transforms data into interactive charts, dashboards, and KPI widgets directly within an AI client's chat interface. It provides a wide variety of visualization options without requiring users to leave their current workflow.

Security Assessment
The overall risk is Medium. The application accesses the user's home directory (`os.homedir`), which is flagged as a failure in standard security checks. However, this specific access is contextually expected and required to resolve cross-platform configuration paths (such as macOS's `~/Library/Application Support`). The tool does not execute dangerous shell commands and contains no hardcoded secrets.

That said, it does make outbound network requests, likely to fetch external charting libraries, assets, or to support its live preview server. It also reads environment variables, which is standard for configuring the server's port and connection settings. Users should be aware that it interacts with the local file system and the external network.

Quality Assessment
The project appears to be actively maintained, with its last push occurring very recently. It has a modest but growing community footprint with 14 GitHub stars. There is a minor inconsistency in its repository health: the automated scan detected the license as "NOASSERTION," though the project's own badges explicitly claim an "FSL-1.1-MIT" license. The documentation is highly detailed, providing clear installation instructions and broad compatibility with popular MCP clients like Claude Desktop and VS Code.

Verdict
Use with caution — while it is a well-documented and actively maintained tool, users should be aware of its local file system access and outbound network requests.
SUMMARY

Turn your data into interactive dashboards inside any AI client - MCP Apps powered

README.md

MCP Dashboards

Your AI can talk about data. Now it can show it.

npm
Glama Quality
Glama Security
License: FSL-1.1-MIT
Buy Me A Coffee
GitHub Sponsors

MCP Dashboards demo
Infrastructure Command Center dashboard  Chart Catalog - 31 chart tools  Theme Catalog - 21 themes
Click any thumbnail to see full size

The problem

We use AI for everything - analysis, reports, strategy. But when it comes to actually seeing the story in your data, you're stuck copying numbers into a spreadsheet and building charts yourself. The conversation has the insight. The visualization is somewhere else.

The solution

MCP Dashboards renders interactive charts, dashboards, and KPI widgets directly inside your AI conversation. 31 tools covering 44+ chart subtypes (bar has stacked/drilldown, hero has 11 variants, etc.), 21 themes, live polling, PNG/PPT/A4 export - all from a single MCP server. No browser tabs, no copy-paste, no context switching.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "dashboard": {
      "command": "npx",
      "args": ["-y", "mcp-dashboards", "--stdio"]
    }
  }
}

Claude Code / VS Code

claude mcp add dashboard -- npx -y mcp-dashboards --stdio

Remote (Streamable HTTP)

npx mcp-dashboards
# Server starts on http://localhost:3001/mcp

Supported clients

Works in any MCP Apps-compatible client: Claude Desktop, Claude Web, VS Code (GitHub Copilot), Goose, Postman, MCPJam. ChatGPT support is rolling out.

Just ask

No API to learn. Describe what you want in plain English:

  • "Compare Q1 vs Q2 revenue by region as a bar chart"
  • "Show my portfolio allocation as a donut chart with the boardroom theme"
  • "Build a dashboard with monthly sales KPIs and a trend line"
  • "Visualize website traffic by country on a world map"
  • "Track Bitcoin price live, updating every 30 seconds"
  • "Show the conversion funnel from signup to purchase"
  • "Rank the team by performance using a radar chart"

The AI picks the right tool, formats your data, and renders the chart inline. Click any data point to ask follow-up questions.

Interactive charts, not images

Every chart is interactive HTML rendered directly in your conversation:

  • Explore in-chat - hover tooltips, click-to-select (feeds back to the AI), drill-down with breadcrumbs, scroll-zoom up to 12x on maps and heatmaps
  • Live polling - real-time charts that auto-update from any API on a timer
  • Export anywhere - PPT (16:9 slides), A4 (paginated with smart page breaks), PNG, CSV
All 31 Tools
Tool Type Best For
render_pie_chart Pie/Donut Composition - "what makes up the whole?"
render_bar_chart Bar Comparison - vertical, horizontal, stacked, drill-down
render_line_chart Line/Area Trends - smooth curves, gradient fills, time series
render_scatter_chart Scatter Relationships - per-point labels, annotations, quadrants
render_candlestick_chart Candlestick Finance - OHLC data with volume bars
render_radar_chart Radar Multi-axis comparison - skills, scores, product attributes
render_treemap_chart Treemap Hierarchy - nested rectangles sized by value
render_sankey_chart Sankey Flow - money, users, or resources between stages
render_wordcloud_chart Word Cloud Frequency - sized words from text analysis
render_boxplot_chart Boxplot/Violin Distribution - quartiles, outliers, density shapes
render_live_chart Live Real-time - auto-polls any MCP tool on a timer
poll_http Data proxy Fetch JSON from any HTTP endpoint - secure presets or public URLs
render_bullet_chart Bullet KPI vs target - 2-8 zone bands with labels
render_lollipop_chart Lollipop Ranking - clean dots with optional target markers
render_dumbbell_chart Dumbbell Gaps - before/after with scale labels and zone bands
render_variance_chart Variance Budget - actual vs budget, color-coded over/under
render_funnel_chart Funnel Conversion - staged drop-off with percentages
render_slope_chart Slope Change - ranking shifts between two periods
render_waffle_chart Waffle Proportion - 10x10 grid showing composition
render_sparkline_chart Sparkline Compact trends - mini cards with change indicators
render_radial_cluster Radial Health check - multi-metric ring gauges with status
render_waterfall_chart Waterfall Cumulative - cascading bars showing impact
render_heatmap_chart Heatmap Intensity - 2D grid with color mapping
render_geo_chart Geo/Map Geography - color-coded countries by value (choropleth)
render_bubble_map Bubble Map Pin map - sized circles at lat/lng coordinates
render_timeline_chart Timeline Progress - milestone tracker with status indicators
render_hero_metric Hero KPI widgets - 11 variants (progress ring, gem, orb, NPS, etc.)
render_dashboard Dashboard Everything - KPI cards + multiple charts in responsive grid
render_table Table Data - sortable columns, striped rows, CSV export
render_from_json Auto-detect Any JSON data - picks the best chart automatically
render_from_url URL fetch Fetches JSON from a URL and auto-visualizes
Which chart should I use?
Question Best Chart Also Works
"What makes up the whole?" Pie/Waffle Treemap, Stacked bar
"How do values compare?" Bar Lollipop, Bullet, Radar
"What's the trend over time?" Line Sparkline, Slope
"Are we hitting targets?" Bullet Variance, Radial
"Where's the gap?" Dumbbell Variance
"How does X relate to Y?" Scatter Heatmap
"What's the conversion rate?" Funnel Waterfall, Sankey
"What changed between periods?" Slope Dumbbell
"What's the financial picture?" Candlestick Line
"Show me the KPI" Hero metric Dashboard
"What's the distribution?" Boxplot Violin (same tool)
"Where does money/traffic flow?" Sankey Treemap
"How do options score across axes?" Radar Heatmap
"What are the top keywords?" Word Cloud Bar, Treemap
"Where are users/sales/revenue?" Geo map Bubble map, Heatmap
"Monitor this in real-time" Live chart -

Themes

21 built-in themes. Pass theme to any tool.

Family Themes
Classic boardroom, corporate, sales-floor, golden-treasury, clinical, startup, ops-control, tokyo-midnight, zen-garden, consultant
Black/AI black-tron (cyan neon), black-elegance (warm gold), black-matrix (green hacker)
Forest forest-amber (autumn), forest-earth (terracotta)
Sky sky-light (airy blue), sky-ocean (deep navy), sky-twilight (sunset)
Office office-red (corporate red, white bg - report-ready)
Gray/ML gray-hf (warm yellow accent), gray-copilot (teal on dark)

Mix-and-match with palette, typography (8 options: system, mono, professional, editorial, bold, techno, cyberpunk, luxury), and effects (5 presets: none, subtle, shimmer, neon, energetic).

Live Polling

Real-time charts that auto-update from any API. The live chart polls data via poll_http, which supports two modes:

Secure presets (authenticated APIs)

Configure presets via env vars. Credentials stay server-side and never appear in the conversation.

{
  "mcpServers": {
    "dashboard": {
      "command": "npx",
      "args": ["-y", "mcp-dashboards", "--stdio"],
      "env": {
        "POLL_PRESET_T212_CASH_URL": "https://live.trading212.com/api/v0/equity/account/cash",
        "POLL_PRESET_T212_CASH_HEADERS": "{\"Authorization\": \"Bearer YOUR_API_KEY\"}"
      }
    }
  }
}

Then ask: "Monitor my portfolio total and P/L live" - the AI uses render_live_chart with pollArgs: { preset: "t212_cash" }.

Naming: POLL_PRESET_<NAME>_URL and POLL_PRESET_<NAME>_HEADERS (JSON object).

Public URLs (no auth needed)

For public APIs, use the URL directly:

"Show me Bitcoin price updating every 30 seconds" - uses pollArgs: { url: "https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd" }.

How It Works

Built on MCP Apps. You ask the AI to visualize data, it calls the right tool, and the chart renders inline in your conversation. Self-contained - zero CDN, zero external requests.

MCP Apps supported (inline rendering): Claude Desktop, VS Code Insiders + MCP Apps extension, Goose, Postman.

No MCP Apps support? No problem. When the server detects your client can't render inline, every chart response includes:

  • A clickable http://localhost:XXXX/chart/{id} link - opens the full interactive dashboard in your default browser
  • A standalone HTML file (file:///...chart-{id}.html) - self-contained, works offline, can be emailed or archived

Works in Claude Code, Cursor, older VS Code, and any other MCP client. Tool annotations (readOnlyHint, idempotentHint, openWorldHint) help clients reason about tool behavior.

Opt-out: set env var MCP_DASHBOARDS_DISABLE_PREVIEW=1 to skip the preview links entirely.

Requirements: Node.js 18+.

Contributing
git clone https://github.com/KyuRish/mcp-dashboards.git
cd mcp-dashboards
npm install
npm run build
npm run serve   # http://localhost:3001
npm run dev     # watch mode

Support

If MCP Dashboards is useful to you:

Buy Me A Coffee
GitHub Sponsors

Privacy

All processing happens locally. No data is collected, transmitted, or stored. External network calls are render_from_url and poll_http - both require you to explicitly provide the URL. Credentials in env var presets never leave your machine. The browser preview server binds only to 127.0.0.1 (localhost) and is not reachable from other devices.

License

FSL-1.1-MIT - Free to use for any purpose except building a competing commercial product. Each version converts to MIT two years after release. For commercial licensing, contact [email protected].

Reviews (0)

No results found