Scribus MCP

Scribus MCP

MCP服务器 Scribus --允许LLM以编程方式创建专业的RGB/CMYK布局。

建筑

Claude Code/Desktop ←(MCP stdio)→ server.py ←(subprocess NDJSON)→ Scribus -g -py bridge.py

Scribus作为一个持久的子进程无头运行。桥接脚本在Scribus的嵌入式Python中执行，通过stdin接收JSON命令，通过stdout返回结果。突变会自动保存在延迟30秒的计时器上（将快速更改批处理为一次写入）。新文档保存到 ~/.scribus-mcp/workspace/document.sla；打开的文档将保存回其原始路径。

先决条件

• Python 3.10+
• 紫外线 包管理器
• Scribus 安装在以下位置之一：

- macOS： /Applications/Scribus.app/Contents/MacOS/Scribus - Linux： /usr/bin/scribus - 窗户： C:\Program Files\Scribus 1.6\Scribus.exe - 或设置 SCRIBUS_EXECUTABLE env var（请参见 自定义Scribus路径)

设置

git clone https://github.com/chrisgliddon/scribus-mcp.git
cd scribus-mcp
uv sync

码头工人

如果你不想在本地安装Scribus或uv，请构建Docker镜像：

docker build -t scribus-mcp .

然后使用下面基于Docker的MCP配置示例——不需要本地Scribus或uv。

在Claude代码中配置

添加 .mcp.json 在项目根目录中，或 ~/.claude.json 用于所有会话的全局访问。

原生（uv）-macOS/Linux：

{
  "mcpServers": {
    "scribus": {
      "command": "uv",
      "args": ["--directory", "/path/to/scribus-mcp", "run", "scribus-mcp"]
    }
  }
}

原生（uv）-Windows：

{
  "mcpServers": {
    "scribus": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\scribus-mcp", "run", "scribus-mcp"]
    }
  }
}

Docker（跨平台）：

{
  "mcpServers": {
    "scribus": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "scribus-mcp"]
    }
  }
}

在Claude桌面中配置

添加一个 "scribus" 进入 mcpServers 配置文件中的对象：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

原生（uv）-macOS/Linux：

{
  "mcpServers": {
    "scribus": {
      "command": "uv",
      "args": ["--directory", "/path/to/scribus-mcp", "run", "scribus-mcp"]
    }
  }
}

原生（uv）-Windows：

{
  "mcpServers": {
    "scribus": {
      "command": "uv",
      "args": ["--directory", "C:\\path\\to\\scribus-mcp", "run", "scribus-mcp"]
    }
  }
}

Docker（跨平台）：

{
  "mcpServers": {
    "scribus": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "scribus-mcp"]
    }
  }
}

工具

文件

颜色

文本和排版

图像和形状

图层和分组

表格

布局和母版页

PDF导出

高级

示例提示

创建一个A4文档，在C=100 M=80 Y=0 K=20处定义一种名为“BrandBlue”的CMYK颜色，在顶部中心添加一个36pt的标题“Hello World”，在其后面绘制一个蓝色矩形，然后以PDF格式导出到~/Desktop/test.PDF

打开一个US Letter横向文档，将图像放在左上角的~/logo.png处，缩放为50x50mm，在其下方添加正文，导出为PDF

打开文件~/Documents/layout.sla，显示第1页上的对象，删除旧的“header_text”框架，并将其替换为顶部中心24pt的新标题“Updated Title”

创建一个245x290mm的封面书籍，带有3mm的出血、不对称的边距（顶部=17，底部=20，左侧=20，右侧=15），设置一个13pt的基线网格，在DejaVu Serif 9.5pt中定义一个对齐对齐的“正文”段落样式，然后导出为PDF/X-4，带有裁剪标记和ISOcoat_v2 ICC配置文件

发展

# install dev deps
uv sync

# run tests
uv run pytest tests/ -v

# test with MCP Inspector
npx @modelcontextprotocol/inspector uv run scribus-mcp

配置

自定义Scribus路径

如果Scribus不在标准位置：

macOS/Linux（bash/zsh）：

export SCRIBUS_EXECUTABLE=/path/to/scribus

Windows（命令提示符）：

set SCRIBUS_EXECUTABLE=C:\path\to\Scribus.exe

Windows（PowerShell）：

$env:SCRIBUS_EXECUTABLE = "C:\path\to\Scribus.exe"

超时和保存间隔

运作原理

1. 在第一次工具调用时， client.py 启动Scribus无头(-g -ns -py bridge.py)
2. bridge.py 重定向stdout以避免协议污染，发送 {"ready": true} 哨兵
3. 客户端通过stdin发送NDJSON命令，从stdout读取JSON响应
4. 每个命令都有一个超时（默认为30秒）——如果Scribus停滞，进程将被终止，并在下次调用时自动重新启动
5. 突变被批量保存为延迟自动保存（默认每30秒一次）；强制保存在PDF导出之前和关闭时运行
6. 新文档保存到 ~/.scribus-mcp/workspace/document.sla；打开的文档保存回其原始路径

许可证

麻省理工学院——见 许可证