mcp肩胛骨
](https://www.npmjs.com/package/@binaryloader/mcp-scapple)
用于读取、写入和呈现的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→backgroundColorDefaultTextColor→defaultTextColorDefaultFont（UISettings）→defaultFontNoteXPadding（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许可证获得许可-请参阅 许可证 文件以获取详细信息。