mcp-ascii图表
项目介绍
mcp-ascii-charts
一个用于在终端中直接生成ASCII图表的Model Context Protocol服务器。
🎯 功能
- 纯ASCII图表 - 轻量级的终端环境可视化
- MCP集成 - 兼容Claude、Cursor和其他MCP客户端
- 无GUI依赖 - 适用于服务器和SSH环境
- 高度可定制 - 可配置尺寸、颜色和样式
📊 支持的图表类型
- 折线图 - 时间趋势的折线图
- 柱状图 - 横向和纵向柱状图
- 散点图 - 数据相关性的散点图
- 直方图 - 分布直方图
- 迷你图 - 内联迷你图表
🚀 快速安装
在npm上可用
第一步：全局安装
# 从npm全局安装（MCP服务器所需）
npm install -g mcp-ascii-charts
# 或者从GitHub安装
npm install -g git+https://github.com/gianlucamazza/mcp-ascii-charts.git
第二步：配置您的MCP客户端
添加到您的Claude Desktop配置文件中：
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"
}
}
}
第三步：重启Claude Desktop
配置后，重启Claude Desktop以加载MCP服务器。
💡 使用示例
折线图
月度销售（2024）
100 ┤ ╭╮
90 ┤ ╭─╯╰╮
80 ┤ ╭─╯ ╰╮
70 ┤ ╭─╯ │
60 ┤ ╭──╯ ╰╮
50 ┤ ╭──╯ │
40 ┤ ╭──╯ ╰─
30 ┤ ╭──╯
20 ┤ ╭──╯
10 ┤ ╭──╯
0 ┼────────────────╯
Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec
柱状图
团队表现
前端 ████████████████████████████ 85%
后端 ██████████████████████ 67%
运维 ████████████████ 54%
质量 ██████████████████████████████████ 92%
🛠️ MCP工具
| 功能 | 描述 |
|---|---|
create_line_chart | 生成时间数据的折线图 |
create_bar_chart | 创建横向/纵向柱状图 |
create_scatter_plot | 可视化变量之间的相关性 |
create_histogram | 显示频率分布 |
create_sparkline | 用于紧凑仪表板的小型图表 |
📋 参数
{
"data": [10, 25, 30, 45, 60],
"labels": ["Q1", "Q2", "Q3", "Q4", "Q5"],
"title": "季度增长",
"width": 60,
"height": 15,
"color": "蓝色"
}
🎨 自定义
- 尺寸：配置宽度和高度
- 颜色：支持ANSI颜色（12种颜色可用）
- 灵活的数据输入：带有可选标签的数组
- Unicode渲染：使用框绘字符实现平滑视觉效果
🛠️ 开发
# 克隆仓库
git clone https://github.com/gianlucamazza/mcp-ascii-charts.git
cd mcp-ascii-charts
# 安装依赖
npm install
# 在开发模式下运行
npm run dev
# 运行测试
npm test
# 构建生产版本
npm run build
📚 文档
🐛 问题和支持
📄 许可证
MIT许可证 - 详情见LICENSE文件。
🙏 贡献
欢迎贡献！请阅读我们的贡献指南，了解如何提交拉取请求、报告问题以及参与项目。