What can you do with this server?

This server generates beautifully formatted ASCII/Unicode tables with full support for Thai, Pali, CJK, emoji, and other complex scripts — and exports them as text, PNG, or SVG. Create tables from raw headers/rows, CSV/TSV, or JSON data, with 9 output formats (grid, box, pipe, safe, html, png, svg) and 10+ grid sub-styles (mysql, gfm, reddit, rounded, unicode, dots, etc.). Auto-formats numeric columns (right-align) and centers headers automatically. Export as images: Render polished PNG images via headless Playwright (ideal for Discord, Telegram, Slack) or scalable SVG vector graphics with embedded HTML and Noto Sans Thai font. Handle complex scripts correctly using wcwidth for display width, properly handling zero-width combining marks (Thai tone marks, Devanagari, etc.). Enable safe_width mode for platforms like Discord or browser code blocks that miscount zero-width characters. Debug and validate tables: * analyze_table — inspect column positions with wcwidth-aware widths to validate alignment. * validate_table_text — check structural integrity (border/data alternation, column count stability, marker consistency). * debug_table — generate a detailed diagnostic report with exact character positions and drift analysis for troubleshooting misaligned Unicode content. Preview styles with sample Thai/Pali or English data using make_table_preview.

How do I use ASCII Table MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ASCII Table MCP Server create a box table with headers: คำบาลี, Roman; rows: กมฺม, kamma; อวิชฺชา, avijjā" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ASCII Table MCP Server

by dhammawatthumpra-coder

Overview Schema Source Related Servers Discussions Admin

Python

Local

ASCII Table MCP Server

Beautiful tables in terminal code blocks AND as polished images — with native Thai, Pali, Roman, CJK, and emoji support.

+------------+------------------+--------+----------------------+
| Pali       | Roman            | Type   | Meaning              |
+------------+------------------+--------+----------------------+
| ปฏิจจสมุปฺปาท | paṭiccasamuppāda | Dhamma | Dependent origination |
| กามจฺฉนฺท    | kāmacchanda      | Nīvaraṇa | Sensual desire       |
| อวิชฺชา      | avijjā           | Kilesa | Ignorance            |
+------------+------------------+--------+----------------------+

Thai + Roman + numbers → pixel-perfect alignment, every row.

🌐 Try it in your browser! → ASCII Table → Image Generator Paste CSV, pick a style, export as PNG / SVG / Grid / Box / Pipe. Thai + emoji ready. No install needed.

Web Tool Preview

Why this exists: Most ASCII table libraries use len() in Python, which counts combining marks (like Thai tone marks, Devanagari vowel signs) as separate characters. This breaks alignment for any language with zero-width characters. This server uses wcwidth — the same library terminals use — so columns line up correctly, on every platform.

Features

9 table formats: grid (+--+), box (┌─┬─┐), pipe (| | |), safe, html, png, svg + more
10 grid sub-styles: mysql, separated, compact, gfm, reddit, rounded, rst, box, unicode, dots — inspired by ozh/ascii-tables
Auto-format: auto-detects numeric columns (right-align) and centers headers
Thai / Pali / CJK / emoji: zero-width combining marks (ิ, ี, ฺ, ◌̱, etc.) align perfectly
Safe width mode: extra padding for platforms where zero-width marks ≠ zero (Discord, browser code blocks)
Direct PNG export: headless Playwright renders styled HTML → cropped PNG with Noto Sans Thai — perfect for Discord/Telegram
Direct SVG export: vector SVG with embedded HTML (foreignObject) — zoomable, embeddable
4 polished HTML styles: dark, light, minimal, compact
CSV / TSV / JSON input: convert from any data source
Debug tools: analyze_table, debug_table, validate_table_text — find and fix alignment issues

Related MCP server: mcp-markdown-tools

Direct PNG Export — One Step to a Gorgeous Table Image

For Discord, Telegram, Slack, or any place that can't render a proper monospace Thai table, use export_png to generate a cropped PNG directly — no browser, no manual screenshot, no crop step.

Style	Preview	Best for
`dark`		Discord / Telegram dark mode
`light`		Documentation, PDF
`minimal`		Blog posts, websites
`compact`		Dense data, narrow screens

{
  "headers": ["Pali", "Roman", "Type", "Meaning"],
  "rows": [
    ["กมฺม", "kamma", "Noun", "action"],
    ["ญาณ", "ñāṇa", "Wisdom", "direct knowing"]
  ],
  "style": "dark"
}

Output: a .png file cropped to just the table — send it with MEDIA:<path> in Discord/Telegram.

Direct SVG Export — Vector That Scales

Use export_svg for images that need to be zoomed, embedded, or edited.

{
  "headers": ["Term", "Translation"],
  "rows": [["กมฺม", "Kamma"], ["ธมฺม", "Dhamma"]],
  "style": "dark"
}

SVG is HTML-backed (foreignObject) with Noto Sans Thai — renders sharp at any size.

Supported Formats

Quick Start

uvx (no install)

uvx --from git+https://github.com/dhammawatthumpra-coder/ascii-table-mcp ascii-table-mcp

pip install

git clone https://github.com/dhammawatthumpra-coder/ascii-table-mcp.git
cd ascii-table-mcp
pip install -e .
python -m ascii_table_mcp

Register with any MCP client

Claude Desktop:

{
  "mcpServers": {
    "ascii-table": {
      "command": "python",
      "args": ["-m", "ascii_table_mcp"]
    }
  }
}

Hermes:

hermes mcp add ascii-table --command "python -m ascii_table_mcp"

MCP Tools

`make_table` — The main event

Parameter	Type	Default	Description
`headers`	`list[str]`	—	Column headers
`rows` / `data`	`list[list[str]]`	—	Data rows
`fmt`	`str`	`"grid"`	`"grid"`, `"box"`, `"pipe"`, `"safe"`, `"html"`
`style`	`str`	`"mysql"`	One of 10 grid styles or 4 HTML styles
`auto_format`	`bool`	`true`	Right-align numbers, center headers
`safe_width`	`bool`	`false`	Extra padding for Discord/browser

Example with style="separated":

{
  "headers": ["Product", "Price", "Qty"],
  "rows": [
    ["Noodle Soup", "45", "3"],
    ["Fried Rice", "55", "2"]
  ],
  "fmt": "grid",
  "style": "separated"
}

+============+======+=======+
|  Product   | Price |  Qty  |
+============+======+=======+
+------------+------+-------+
| Noodle Soup |   45 |     3 |
+------------+------+-------+
| Fried Rice  |   55 |     2 |
+------------+------+-------+

Notice: auto_format=true right-aligns Price and Qty columns, centers headers.

`make_table_from_csv`

{
  "csv_text": "Name,Role,Score\nAlice,Admin,95\nBob,User,87",
  "fmt": "grid"
}

`make_table_from_json`

{
  "json_data": "[[\"Term\",\"Meaning\"],[\"Kamma\",\"Action\"],[\"Dhamma\",\"Truth\"]]",
  "fmt": "box"
}

`export_png` — Direct PNG export

Render table as cropped PNG via headless Playwright.

Parameter	Type	Default	Description
`headers`	`list[str]`	—	Column headers
`rows` / `data`	`list[list[str]]`	—	Data rows
`style`	`str`	`\"dark\"`	`\"dark\"`, `\"light\"`, `\"minimal\"`, `\"compact\"`
`font_size`	`int`	`24`	Font size in px

{
  "headers": ["คำบาลี", "Roman"],
  "rows": [["กมฺม", "kamma"], ["ธมฺม", "dhamma"]],
  "style": "dark"
}

→ Returns file path to cropped PNG. Send with MEDIA:<path>.

`export_svg` — Direct SVG export

Render table as vector SVG (foreignObject with styled HTML).

Same parameters as export_png. Returns file path to .svg.

Debug tools

debug_table — shows exact char positions with drift analysis
analyze_table — validates column alignment in +--+ tables
validate_table_text — structural check: column count, border alternation, format detection

Thai Character Width: The Problem This Solves

Discord, browser code blocks, and some terminals don't respect Unicode zero-width combining marks.
Characters like ิ ี ื ู ฺ each take up width=1 on screen, but wcwidth says they're width=0.

len("ก๋วยเตี๋ยว")   → 10  ← Python counts combining marks
wcwidth("ก๋วยเตี๋ยว") → 7   ← Reality: only 7 visible column positions

Solution: `safe_width=True`

When enabled, the renderer uses len() (counts every character as width 1) instead of wcwidth, then adds padding for each combining mark:

{
  "headers": ["Name", "Price"],
  "rows": [["ก๋วยเตี๋ยว", "45"]],
  "fmt": "grid",
  "safe_width": true
}

+----------------+------+
|      Name      | Price |
+----------------+------+
| ก๋วยเตี๋ยว     |   45 |
+----------------+------+

Without safe_width (discord will misalign):

+------------+------+
|    Name    | Price |
+------------+------+
| ก๋วยเตี๋ยว |   45 |  ← column drifts right by 3 chars
+------------+------+

Future: Per-Character Width Database

wcwidth and len() are both approximations. A future plan is to build a lookup table of actual display widths for each Thai character on major platforms (Windows Discord, macOS Discord, Linux terminal) for 100% guaranteed alignment.

Grid Styles Reference

Style	Top border	Header sep	Data sep	Bottom	Notes
`mysql`	`+--+`	`+--+`	`+--+`	`+--+`	default
`separated`	`+==+`	`+==+`	`+--+`	`+--+`	bold header separator
`compact`	none	`---`	none	none	frameless
`gfm`	none	`\|--\|`	none	none	GitHub Flavored Markdown
`reddit`	none	`--\|--`	none	none	Reddit tables
`rounded`	`.--.`	`:+:`	none	`'--'`	rounded corners
`rst`	`+==+`	`+--+`	`+==+`	`+==+`	reStructuredText
`box`	`┌┬┐`	`├┼┤`	`├┼┤`	`└┴┘`	Unicode box-drawing
`unicode`	`╔╦╗`	`╠╬╣`	`╠╬╣`	`╚╩╝`	double-line
`dots`	`┌┬┐`	`├┼┤`	none	`└┴┘`	no row separators

Format comparison

Format	Example	Best for
`grid`	`+----+----+`	Terminal, code review, GitHub
`box` / `safe`	`┌────┬────┐`	Presentation, formal docs
`pipe`	`\| \| \|`	Markdown-native
`grid` + `safe_width`	`+------+----+`	Discord, browser (zero-width ≠ 0)
`png`	`<image>`	Direct export — Discord/Telegram/chat apps
`svg`	`<vector>`	Vector — zoomable, embeddable

CLI Usage

# CSV args → grid
python -m ascii_table_mcp.generate_table --grid 'Name,Age' 'Alice,30' 'Bob,25'

# TSV pipe → grid
printf 'Name\tAge\nAlice\t30\n' | python -m ascii_table_mcp.generate_table --tsv --grid

# JSON
python -m ascii_table_mcp.generate_table --json '{"headers":["A","B"],"rows":[["1","2"]]}' --grid

+-------+-----+
| Name   | Age |
+-------+-----+
| Alice  | 30  |
| Bob    | 25  |
+-------+-----+

Architecture

ascii-table-mcp/
├── ascii_table_mcp/
│   ├── __init__.py       # MCP server entry (FastMCP) — 9 tools
│   ├── generate_table.py # Core rendering engine + HTML + PNG + SVG
│   └── thaiwidth.py      # Thai-aware display width
├── server.py             # Thin CLI wrapper
├── table_to_image.py     # HTML → screenshot helper (legacy)
├── table_screenshot.py   # HTML generator (legacy)
├── requirements.txt      # mcp + wcwidth
├── pyproject.toml         # uv/pip packaging
├── ascii-table-mcp.bat   # Windows launcher
├── LICENSE               # MIT
├── README.md             # This file (English)
├── README_TH.md          # Thai documentation
├── GUIDE_TH.md           # Thai user guide
├── GUIDE_EN.md           # English user guide
└── examples/
    ├── ex_dark.png
    ├── ex_light.png
    ├── ex_minimal.png
    └── ex_compact.png

Why `wcwidth` Instead of `len()`?

len("กมฺม")      → 4  ❌ (counts the dot-below as a character)
wcswidth("กมฺม") → 3  ✅ (dot-below is zero-width)

Using len() for table layout:

+----------+-----------+   ← border width 8
| Pali     | Roman     |   ← "กมฺม" = 4 chars → padding 4 → total 9 ❌
+----------+-----------+

Using wcwidth:

+---------+-----------+
| Pali    | Roman     |   ← "กมฺม" = width 3 → padding 5 → total 8 ✅
+---------+-----------+

ozh/ascii-tables — original table style system
dmarsters/ascii-art-mcp — decorative ASCII art
schachmat/wego — Go terminal weather (go-runewidth)
wcwidth — Python wcwidth implementation

License

MIT — free for personal and commercial use.

Available Tools

7 tools

analyze_tableA

Analyze column positions in a grid table (+---+).

Uses display-width space (via wcwidth) for position comparison, so Thai/Pali combining marks (พิทุ, สระบน/ล่าง) are handled correctly.

Scans '+' markers in border lines to define column boundaries, then validates '|' alignment in data rows.

Args: table_text: A +---+ grid table as raw text

Returns: Analysis report: column positions, alignment validation, parsed cells

Inputs: table_text (required). Returns: result

debug_tableC

Render and diagnose a table — shows exact character positions.

Produces a detailed report: plain table, annotated position analysis, and drift comparison between border markers and data pipes.

Args: headers: Optional column headers rows: Data rows data: Alias for rows

Returns: Diagnostic report with position annotations

Inputs: headers, rows, data. Returns: result

make_tableA

Render data as a table.

Args: headers: Optional list of column header strings rows: List of data rows, each a list of strings data: Alias for rows -- pass data here if you prefer (cannot use both) fmt: "grid" (default) for ASCII grid, "box" for Unicode box-drawing, "pipe" for Markdown pipe table, "safe" for char-count padding style: Table style (for grid fmt). One of: mysql, separated, compact, gfm, reddit, rounded, rst, box, unicode, dots auto_format: Auto-detect numeric columns (right-align) and center headers safe_width: Count zero-width combining marks as width 1 (for Discord/browsers)

Returns: Formatted table as a Markdown code block (grid/box/safe) or raw pipe table.

Inputs: headers, rows, data, fmt, +3 more. Returns: result

make_table_from_csvA

Parse a CSV/TSV string and render as a table.

Args: csv_text: Raw CSV-formatted text delimiter: Field delimiter (default: comma). Use '\t' for TSV. has_header: If True (default), first row is treated as column headers fmt: "grid" (default), "box", "safe", or "pipe" style: Table style (for grid fmt) auto_format: Auto-detect numeric columns

Returns: Formatted table.

Inputs: csv_text (required), delimiter, has_header, fmt, +2 more. Returns: result

make_table_from_jsonA

Parse a JSON array and render as a table.

Accepts either:

A 2D array: [["Name", "Value"], ["alpha", "1"], ...]
An object with "headers" and "rows" keys: {"headers":["Name"], "rows":[["alpha"]]}

Args: json_data: JSON string has_header: If True (default), first row is treated as column headers fmt: "grid" (default), "box", "safe", or "pipe" style: Table style (for grid fmt) auto_format: Auto-detect numeric columns

Returns: Formatted table.

Inputs: json_data (required), has_header, fmt, style, +1 more. Returns: result

make_table_previewA

Print a preview/example table with sample data.

Args: style: "thai" (default) -- example with Thai/Pali characters "simple" -- plain English example fmt: "grid" (default), "box", "pipe", or "safe" table_style: Table style for grid fmt (mysql, separated, etc.)

Returns: Formatted example table.

Inputs: style, fmt, table_style. Returns: result

validate_table_textA

Validate structural integrity of a table (box/grid/pipe).

Auto-detects format, then checks:

Border/data line alternation
Marker positions (+, ┬, etc.) are consistent
Column count is stable across rows
First and last lines are correct border type

Args: table_text: Raw table text (box, grid, or pipe format)

Returns: Validation report with any structural issues

Inputs: table_text (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A4/5.0

Scored 2026-06-09 21:02 across 7 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: analysis, debugging, creation from various inputs, preview, and validation. Overlap is minimal, and agents can easily select the right tool.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern using snake_case, making the set predictable and easy to navigate.

Tool Count5/5

Seven tools is within the ideal range (3-15) and each tool contributes meaningfully to the server's table-focused scope without being excessive.

Completeness5/5

The tool set covers the full lifecycle: creation from raw data, CSV, JSON, preview, analysis, debugging, and validation. No obvious gaps for the intended domain.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

tabletopsimulator
io.github.doc2mcp
MCP server for tabletopsimulator documentation, generated by doc2mcp.
Games & Gamification Documentation Access Developer Tools
24
https://doc2mcp.site/api/mcp/1b5ee653-f763-415b-8d1b-46c60f17b363/mcp
EBCDIC to ASCIIB
io.github.phreakocious
An MCP server that measures MCP client behaviour and converts EBCDIC to ASCII, which nobody needs.
Developer Tools Monitoring
41
https://mcp.phreakocious.net/mcp
Tabula MCPB
click.tabula.www
Bar-first MCP server for Tabula chart authoring, PNG rendering, and editor handoff.
Data Visualization Developer Tools App Automation
2
https://www.tabula.click/api/mcp/stream
strata
ai.klavis
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Agent Orchestration Autonomous Agents Developer Tools
25,748
https://strata.klavis.ai/mcp/

Related MCP Servers

ASCII Banner MCP Server
Developer Tools Shell Access
guilyx
A
license
A
quality
D
maintenance
An MCP server for getting ASCII banners
Updated 9 months ago (2026-02-02 06:38 UTC)
2
MIT
mcp-markdown-tools
Developer Tools Content Management Systems Documentation Access
rog0x
A
license
Not graded
quality
D
maintenance
An MCP server that provides tools for analyzing, linting, formatting, and generating Markdown content. It enables users to programmatically manage Markdown files through features like table of contents generation, statistics calculation, and JSON-to-table conversion.
Updated 8 months ago (2026-03-21 20:21 UTC)
53 npm
1
MIT
monosketch-mcp
Software Architecture Design Tools
supersterling
F
license
Not graded
quality
D
maintenance
An MCP server that enables AI agents to create beautiful ASCII diagrams using Unicode box-drawing characters, with support for stateful canvas operations, multiple shape types, and style customization.
Updated 9 months ago (2026-02-13 21:45 UTC)
2
-
Tools MCP Server
Developer Tools Documentation Access Content Management Systems
dongood
A
license
A
quality
D
maintenance
An MCP server that provides utility tools for markdown processing, including ADF-to-markdown conversion, table formatting, and table of contents management.
Updated 9 months ago (2026-02-11 22:57 UTC)
7
MIT

ASCII Table MCP Server

Features

Direct PNG Export — One Step to a Gorgeous Table Image

Direct SVG Export — Vector That Scales

Supported Formats

Quick Start

uvx (no install)

pip install

Register with any MCP client

MCP Tools

make_table — The main event

make_table_from_csv

make_table_from_json

export_png — Direct PNG export

export_svg — Direct SVG export

Debug tools

Thai Character Width: The Problem This Solves

Solution: safe_width=True

Future: Per-Character Width Database

Grid Styles Reference

Format comparison

CLI Usage

Architecture

Why wcwidth Instead of len()?

Related Projects

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

ASCII Banner MCP Server

mcp-markdown-tools

monosketch-mcp

Tools MCP Server

`make_table` — The main event

`make_table_from_csv`

`make_table_from_json`

`export_png` — Direct PNG export

`export_svg` — Direct SVG export

Solution: `safe_width=True`

Why `wcwidth` Instead of `len()`?