formatika

@formatika/mcp

直接通过 Agent 使用 formatika.app 转换、调整大小、压缩、裁剪和旋转文件。

Agent 可以使用这些工具；在任务需要处理文件之前，文件始终留在你的设备上，任务完成后会立即返回。

使用方法

无需安装，也无需账号即可开始：

npx @formatika/mcp

Claude Code

claude mcp add formatika -- npx -y @formatika/mcp

Claude Desktop、Cursor 和其他客户端

将以下内容添加到客户端配置的 MCP 服务部分：

{
  "mcpServers": {
    "formatika": {
      "command": "npx",
      "args": ["-y", "@formatika/mcp"]
    }
  }
}

在 Windows 上，Claude Desktop 启动服务时不会使用 shell，因此无法直接找到 npx。请改用：

{
  "mcpServers": {
    "formatika": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@formatika/mcp"]
    }
  }
}

编辑配置后，请完全重启客户端。

然后直接提出请求

压缩 ./screenshots 中的所有照片，并将结果放到 ./web 中

将此文件夹中的所有 HEIC 文件转换为 JPEG

将 portrait.png 制作成 512×512 的方形头像

工具

工具列表会在启动时从服务获取，因此始终与 formatika 实际支持的功能保持同步——即使新增工具，此 README 也无需更新，你的 Agent 就能使用它。

目前支持图像、音频、视频、PDF、压缩包、字幕和表格：共有三十多种工具。当前工具列表及其功能说明，请访问 formatika.app/mcp。

每个工具都接受 paths（一个或多个文件）以及可选的 outputDir。除非另有指定，结果会写入源文件所在目录；绝不会覆盖已有文件：如果文件名已被占用，就会在名称中加上数字。

限制和密钥

不使用密钥也可以享有每日配额，足以应付偶尔的使用需求。如需大量使用，请在 formatika.app/account 创建密钥并传入：

{
  "mcpServers": {
    "formatika": {
      "command": "npx",
      "args": ["-y", "@formatika/mcp"],
      "env": { "FORMATIKA_API_KEY": "fk_..." }
    }
  }
}

FORMATIKA_URL 可将服务指向其他位置——如果你自行运行 formatika，这会很有用。

隐私

文件会经过处理并删除：无账号时保留两小时，有账号时保留二十四小时。文件不会被查看、分享，也不会用于训练。详见隐私政策。

许可证

MIT

---

关于此代码库

这是 formatika 单体代码库中 packages/mcp 目录的只读镜像，发布出来是为了给此软件包提供公开主页：目录可以链接到这里，安装前想先阅读代码的人也可以查看。

此处的拉取请求无法合并——下次同步时会覆盖这些更改。不过，我们会查看并欢迎问题反馈：错误、缺少的工具以及不便使用的 API。

镜像自提交 e06be38。