基于 Go + MCP Go SDK 的文档转换服务。支持 MCP 和 CLI + Skill 两种模式，容器内集成 pandoc、LibreOffice、markitdown、weasyprint、headless-shell 完成任意文档格式互转。

通过 MCP 协议对接任意支持 MCP 的 AI 工具（OpenCode、Claude Desktop、Cursor、Windsurf 等）。

启动容器：

docker run -d -p 8080:8080 -v /your/docs:/data ghcr.io/xusenlin/document-mcp:v1.3.1

MCP 配置（JSON-RPC over HTTP，Streamable HTTP 传输）：

{
  "mcpServers": {
    "document-mcp": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

不同工具配置位置：

• OpenCode — opencode.json 中 mcp 字段
• Claude Desktop — claude_desktop_config.json 中 mcpServers 字段
• Cursor — .cursor/mcp.json
• Windsurf — mcp.json

无需 MCP 配置，AI 通过 Skill 学习 docker run 命令直接调容器 CLI。本地零依赖。

# 路径规则：源文件父目录挂载到 /data，文件名不变
# /Users/xx/project/report.md  →  -v /Users/xx/project:/data  →  /data/report.md

docker run --rm -v /your/project:/data \
  ghcr.io/xusenlin/document-mcp:v1.3.1 \
  cli pdf /data/report.md

Skill 文件位于 skills/document-convert/SKILL.md，复制到对应工具的 skills 目录即可：

• Claude Desktop — ~/.claude/skills/document-convert/SKILL.md
• OpenCode — .opencode/skills/document-convert/SKILL.md
• 通用 — .agents/skills/document-convert/SKILL.md

<image> = ghcr.io/xusenlin/document-mcp:v1.3.1，后续命令以此为镜像。

PDF 输出支持 2 套内置 CSS 主题，通过 theme 参数选择：

生效范围： 仅对 md / latex / tex / rst / org / txt / epub → pdf 生效，html→pdf 和 Office→pdf 不受主题控制。

MCP 调用示例：

{ "tool": "convert_to_pdf", "arguments": { "source_path": "/data/doc.md", "theme": "paper" } }

CLI 调用示例：

docker run --rm -v /path:/data ghcr.io/xusenlin/document-mcp:v1.3.1 cli pdf /data/doc.md --theme=paper

• 输出文件自动生成在源文件同目录，文件名相同，仅扩展名变化
• merge_pdf 输出固定命名为 merged.pdf
• split_pdf 输出命名为 {名}_page_N.pdf 或 {名}_range_N.pdf
• 目标文件已存在时报错，保护已有文件
• 同格式转换直接跳过，返回源路径

make build          # 本地编译
make docker-dev     # 本地构建并启动测试容器
make docker-push    # 构建多架构镜像并推送
make run            # 本地运行 HTTP 模式

go run ./cmd/cli/                        # 本地运行 HTTP 模式
MCP_ADDR=:9090 go run ./cmd/cli/         # 指定端口
go run ./cmd/cli/ pdf /data/doc.md       # CLI 模式测试