🚀 MCP Server Chart - 完全离线版本
 ](https://nodejs.org/) 
一个完全离线的 Model Context Protocol (MCP) 图表生成服务器,支持 15 种图表类型,无需网络连接即可生成高质量的 SVG 图表。
✨ 主要特性
- 🌐 完全离线 - 无需任何网络连接
- 📊 15种图表类型 - 涵盖基础图表、统计图表、高级图表和关系图表
- ⚡ 即时响应 - 平均生成时间
cd mcp-server-chart npm install npm run build
打包整个项目目录
tar -czf mcp-server-chart-offline.tar.gz .
2. **在目标环境部署**解压到目标环境
tar -xzf mcp-server-chart-offline.tar.gz cd mcp-server-chart
直接运行(不需要 npm install)
node build/index.js
### Docker 部署
FROM node:18-alpine
WORKDIR /app COPY package*.json ./ RUN npm ci --only=production
COPY build/ ./build/ COPY demo.html ./ COPY demo-server.js ./
EXPOSE 3000 CMD ["node", "demo-server.js"]
## 🎯 性能指标
| 指标 | 数值 |
|------|------|
| 支持图表类型 | 15 种 |
| 平均生成时间 | < 1ms |
| 平均输出大小 | ~1.3KB |
| 内存占用 | < 50MB |
| 网络依赖 | 0 |
| 启动时间 | < 2s |
## 🔍 技术架构
### 核心组件
- **图表生成器** (`src/utils/generate-offline.ts`) - 纯 JavaScript SVG 生成
- **MCP 服务器** (`src/server.ts`) - Model Context Protocol 实现
- **工具定义** (`src/index.ts`) - MCP 工具注册和处理
- **演示服务器** (`demo-server.js`) - HTTP API 和演示页面
### 数据流程
1. **接收请求** - MCP 客户端或 HTTP 请求
2. **数据验证** - 检查图表类型和数据格式
3. **SVG 生成** - 根据类型生成对应的 SVG 图表
4. **Base64 编码** - 转换为 data URL 格式
5. **返回结果** - 可直接使用的图片 URL
## 🛠️ 开发
### 项目结构
mcp-server-chart/ ├── src/ │ ├── index.ts # MCP 工具定义 │ ├── server.ts # MCP 服务器实现 │ └── utils/ │ ├── constants.ts # 图表类型映射 │ ├── generate.ts # 主生成函数 │ ├── generate-offline.ts # 离线生成实现 │ └── ... ├── build/ # 编译输出 ├── demo.html # 演示页面 ├── demo-server.js # 演示服务器 ├── test-all-charts.js # 测试脚本 ├── OFFLINE_USAGE.md # 离线使用文档 └── package.json
### 添加新图表类型
1. 在 `src/utils/constants.ts` 中添加映射
2. 在 `src/utils/generate-offline.ts` 中实现生成函数
3. 在 `src/index.ts` 中注册 MCP 工具
4. 添加测试用例
### 构建命令
npm run build # 编译 TypeScript npm run start # 启动 MCP 服务器 npm run test # 运行测试
## 🤝 贡献
欢迎提交 Issue 和 Pull Request!
### 开发指南
1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 打开 Pull Request
## 📄 许可证
本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
## 🙏 致谢
- [AntV](https://antv.antgroup.com/) - 原始图表库灵感
- [Model Context Protocol](https://modelcontextprotocol.io/) - 协议规范
- 所有贡献者和用户
---
**🎉 现在您可以在完全无网络的环境下使用所有 15 种图表类型的 MCP 图表生成服务了!**
如有问题或建议,请提交 [Issue](https://github.com/your-repo/mcp-server-chart/issues)。