MCP ASCII Charts

mcp-ascii-charts

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)
┤                                        ╭╮    
┤                                      ╭─╯╰╮   
┤                                    ╭─╯   ╰╮  
┤                                  ╭─╯      │  
┤                               ╭──╯        ╰╮ 
┤                            ╭──╯            │ 
┤                         ╭──╯               ╰─
┤                      ╭──╯                   
┤                   ╭──╯                      
┤                ╭──╯                         
       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

Install 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,065
2,128
TypeScript
MIT License
MCP Chart Server
wubbyweb
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.
Last updated -
5
26
TypeScript
quickchart-mcp-server
TakanariShimbo
-
security
F
license
-
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 -
23
TypeScript
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 -
14
2
JavaScript

View all related MCP servers