mcp-ascii-charts

npm version License: MIT Node.js CI npm downloads GitHub stars

A Model Context Protocol server for generating ASCII charts directly in your terminal.

🎯 Features

Pure ASCII charts - Lightweight visualizations for terminal environments
MCP integration - Compatible with Claude, Cursor, and other MCP clients
No GUI dependencies - Perfect for servers and SSH environments
Highly customizable - Configurable dimensions, colors, and styles

📊 Supported chart types

Line Chart - Line graphs for temporal trends
Bar Chart - Horizontal and vertical bar charts
Scatter Plot - Scatter plots for data correlation
Histogram - Distribution histograms
Sparkline - Inline mini-charts

🚀 Quick installation

Available on npm

Step 1: Install globally

# Install globally from npm (required for MCP servers) npm install -g mcp-ascii-charts # Or install from GitHub npm install -g git+https://github.com/gianlucamazza/mcp-ascii-charts.git

Step 2: Configure your MCP client

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{ "mcpServers": { "ascii-charts": { "command": "mcp-ascii-charts" } } }

Step 3: Restart Claude Desktop

After configuration, restart Claude Desktop to load the MCP server.

💡 Usage examples

Line chart

Monthly Sales (2024) 100 ┤ ╭╮ 90 ┤ ╭─╯╰╮ 80 ┤ ╭─╯ ╰╮ 70 ┤ ╭─╯ │ 60 ┤ ╭──╯ ╰╮ 50 ┤ ╭──╯ │ 40 ┤ ╭──╯ ╰─ 30 ┤ ╭──╯ 20 ┤ ╭──╯ 10 ┤ ╭──╯ 0 ┼────────────────╯ Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec

Bar chart

Team Performance Frontend ████████████████████████████ 85% Backend ██████████████████████ 67% DevOps ████████████████ 54% QA ██████████████████████████████████ 92%

🛠️ MCP tools

Function	Description
`create_line_chart`	Generate line charts for temporal data
`create_bar_chart`	Create horizontal/vertical bar charts
`create_scatter_plot`	Visualize correlations between variables
`create_histogram`	Show frequency distributions
`create_sparkline`	Mini-charts for compact dashboards

📋 Parameters

{ "data": [10, 25, 30, 45, 60], "labels": ["Q1", "Q2", "Q3", "Q4", "Q5"], "title": "Quarterly Growth", "width": 60, "height": 15, "color": "blue" }

🎨 Customization

Dimensions: Configure width and height
Colors: ANSI color support (12 colors available)
Flexible data input: Arrays with optional labels
Unicode rendering: Box-drawing characters for smooth visuals

🛠️ Development

# Clone the repository git clone https://github.com/gianlucamazza/mcp-ascii-charts.git cd mcp-ascii-charts # Install dependencies npm install # Run in development mode npm run dev # Run tests npm test # Build for production npm run build

📚 Documentation

🐛 Issues & Support

📄 License

MIT License - see LICENSE file for details.

🙏 Contributing

Contributions are welcome! Please read our Contributing Guidelines for details on how to submit pull requests, report issues, and contribute to the project.

⭐ Star History

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

A Model Context Protocol server that generates lightweight ASCII charts directly in terminal environments, supporting line charts, bar charts, scatter plots, histograms, and sparklines without GUI dependencies.

Related MCP Servers

MCP Server Chartofficial
antvis
A
security
A
license
A
quality
mcp-server-chart
Last updated -
25
4,460
2,852
TypeScript
MIT License
MCP Chart Server
A
security
F
license
A
quality
A Model Context Protocol server that generates TradingView chart visualizations with real-time updates, enabling AI assistants to create and display financial charts through an integration with Chart-IMG API.
quickchart-mcp-server
TakanariShimbo
A
security
F
license
A
quality
This Model Context Protocol (MCP) server provides powerful visualization tools using QuickChart.io APIs. With this MCP, AI assistants can create charts, diagrams, barcodes, QR codes, word clouds, tables, and more.
Last updated -
12
7
ECharts MCP Server
w2xi
-
security
F
license
-
quality
A Model Context Protocol server that generates beautiful chart images from ECharts configurations, supporting various chart types with customizable dimensions.
Last updated -
3
5

View all related MCP servers

MCP ASCII Charts