convertica

"Convert ~/Downloads/report.pdf to Word"
"Merge these three PDFs and compress the result"
"Turn this HEIC photo into a JPG"
"Render https://example.com as a PDF"

MCP 工具

该服务提供两个工具。

list_converters

列出 Convertica 的全部 35 多种转换器及其文件字段和选项。先调用此工具，找到适用于 convert_file 的 tool 标识。无需输入。

{ "type": "object", "properties": {} }

convert_file

使用 convertica.net 的 35 多种转换工具之一转换本地文件，并将结果保存到输入文件旁边（或保存到 output_dir）。需要通过 CONVERTICA_API_KEY 环境变量进行身份验证。

{
  "type": "object",
  "required": ["tool"],
  "properties": {
    "tool": { "type": "string", "description": "Converter slug from list_converters, e.g. pdf-to-word or pdf-organize/merge" },
    "files": { "type": "array", "items": { "type": "string" }, "description": "Absolute paths of input file(s); order matters for multi-file tools" },
    "options": { "type": "object", "description": "Tool-specific options as listed by list_converters, e.g. {angle: 90}" },
    "output_dir": { "type": "string", "description": "Directory to save the result (default: alongside the first input file)" }
  }
}

支持的转换包括：PDF ⇄ Word / Excel / PowerPoint / JPG / HTML / Markdown / Text / EPUB、PDF → PDF/A、HTML / URL → PDF、合并 / 拆分 / 压缩 / 旋转 / 裁剪 / 添加水印 / 签名 / 保护 / 解锁 PDF、图像转换 / 优化 / HEIC → JPG·PNG·PDF 等。完整列表请通过 list_converters 查看，或访问 convertica.net。

设置和 API 密钥

你需要一个 Convertica API 密钥：在 convertica.net/pricing 订阅，然后在 convertica.net/users/api-keys 创建密钥。API 文档：convertica.net/api/docs。

Claude Code

claude mcp add convertica -e CONVERTICA_API_KEY=cvk_live_... -- npx -y convertica-mcp

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "convertica": {
      "command": "npx",
      "args": ["-y", "convertica-mcp"],
      "env": { "CONVERTICA_API_KEY": "cvk_live_..." }
    }
  }
}

使用说明

• 文件从本地磁盘读取并写入；除非传入 output_dir，否则结果会保存到输入文件旁边。
• 转换通过 HTTPS 同步运行；处理后的文件会在响应返回后立即从 Convertica 的服务中删除（详情）。
• API 调用会计入你套餐的月度配额；失败的调用不计入配额。

本地开发

npm install
npm run smoke                        # protocol check, no key needed
CONVERTICA_API_KEY=... npm run smoke # + one real conversion

许可证和致谢

MIT。与 Anthropic 无关联；“Convertica”是 convertica.net 背后的服务。