AI导哈

Scapple文件处理服务

一个用于读取、写入和渲染Scapple (.scap) 文件的MCP服务器，支持将文本转换为脑图并渲染为图像。

  • by binaryloader
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 binaryloader/mcp-scapple

使用说明

英语| 韩语 | 日本语

mcp肩胛骨

用于读取、写入和呈现的MCP（模型上下文协议）服务器 削平 （.scap）文件。Scapple是Literature&Latte的一个头脑风暴工具，它将图表存储为XML。该服务器使AI助手能够直接处理Scapple文件。

特性

  • 阅读scapple：将.scap文件解析为包含注释、背景形状、注释样式和连接的结构化JSON
  • 书写肩胛骨：使用自动双向连接管理从结构化笔记数据创建.scap文件
  • 文本截图：将缩进文本、项目符号列表或编号列表转换为具有自动布局和可选主题渲染的Scapple图
  • 按图像缩放：将.scap文件渲染为PNG，并提供完整的主题支持（背景、颜色、字体、阴影、图案）

示例

您可以使用自然语言创建和渲染图表：

“制作一个关于移动应用程序开发的头脑风暴图，包括设计、后端和测试分支”

用深色主题渲染该图——海军蓝背景、点状图案、无阴影

主题选项

这 scapple-to-image 和 text-to-scapple 工具接受可选 theme 具有以下属性的参数。所有属性都是可选的-省略时 .scap 首先使用文件的设置，然后使用下面的默认值。

画布

属性 类型 默认值 描述
backgroundColor 字符串 #ffffff 画布背景颜色（十六进制）
backgroundPattern 字符串 none 图案类型： none, dots, grid, lines
patternColor 字符串 #cccccc 图案颜色（十六进制）

备注

属性 类型 默认值 描述
strokeColor 字符串 #cccccc 注释边框颜色（十六进制）
strokeWidth 编号 1 注意边框宽度
borderRadius 编号 8 圆角钞票圆角半径
shadowColor 字符串 #00000033 阴影颜色（带字母的十六进制）
shadowEnabled 布尔值 true 启用/禁用阴影
defaultFill 字符串 none 默认注释填充颜色（十六进制）
defaultBorder 字符串 None 默认边框样式： Rounded, Square, Cloud, None

文本

属性 类型 默认值 描述
defaultFont 字符串 Helvetica 默认字体系列
defaultFontSize 编号 12 默认字体大小
defaultTextColor 字符串 #000000 默认文本颜色（十六进制）
defaultAlignment 字符串 Center 默认文本对齐方式： Left, Center, Right
noteXPadding 编号 8 钞票内部水平填充

连接

属性 类型 默认值 描述
lineColor 字符串 #666666 连接线颜色（六角形）
lineWidth 编号 1 连接线宽度
arrowColor 字符串 #666666 箭头颜色（十六进制）

Scapple文件设置

渲染时 .scap 文件，从文件中读取以下设置并将其用作主题默认值（由显式覆盖 theme 参数）：

  • BackgroundColor → backgroundColor
  • DefaultTextColor → defaultTextColor
  • DefaultFont （UISettings）→ defaultFont
  • NoteXPadding （UISettings）→ noteXPadding

每个注释的外观设置（边框颜色、粗细、文本颜色、填充、字体、粗体/斜体）始终优先于主题默认值。

组件

路径 描述
src/index.ts MCP服务器入口点
src/types.ts TypeScript类型定义
src/errors.ts 自定义错误类层次结构
src/lib/parser.ts .scap XML到ScappleDocument解析器
src/lib/builder.ts ScappleDocument到.scap XML构建器
src/lib/renderer.ts SVG/PNG渲染管道
src/lib/layout.ts 文本到图表自动布局
src/lib/svg/ SVG生成模块（形状、连接、文本、定义）
src/tools/ MCP工具处理程序
examples/ 渲染样本

需求

  • Node.js 18+
  • npm

用法

在Claude代码中配置

claude mcp add --transport stdio --scope user scapple -- npx -y @binaryloader/mcp-scapple

工具使用

阅读scapple -读取Scapple文件：

filePath: "/path/to/diagram.scap"

书写肩胛骨 -创建Scapple文件：

filePath: "/path/to/output.scap"
document: { notes: [{ x: 100, y: 100, text: "Hello" }] }

文本截图 -将文本转换为图表：

text: "Root Topic\n  Branch A\n    Leaf 1\n  Branch B"
filePath: "/path/to/output.scap"
renderImage: true

按图像缩放 -渲染为PNG格式：

filePath: "/path/to/diagram.scap"
scale: 2
theme: { backgroundColor: "#1a1a2e", backgroundPattern: "dots", shadowEnabled: false }

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP