Aktar
ZH
下载下载

适用于 Cursor 的 Aktar

从 Cursor 上传文件到你自己的存储桶

把 Aktar 添加到 Cursor，它的智能体就能把图片和文件上传到你自己的 S3、Cloudflare R2 或 Backblaze B2 存储桶，生成临时链接，还能查看存储桶里的内容。它在你电脑上的 Aktar 应用旁边运行，所以你的存储密钥始终不会离开 Aktar。

开始设置getaktar/cliv0.6.0

上传 public/og-image.png，并在 og:image meta 标签中使用它的 URL。

已调用 Aktarupload_file{ "path": "public/og-image.png" }

已上传。我把这个 URL 放进了 og:image 标签：

https://files.example.com/2026/11/og-image.png

你可以这样说

  • 用于文档和更新日志的图片

    “上传 docs/ 里的截图，并在 CHANGELOG.md 中加上链接。”

    智能体逐个上传图片，并把链接写在合适的位置。Aktar 按上传目标的设置转换和清理图片。

    工具: upload_file

  • 会过期的链接

    “给我 Builds 存储桶里 backup.sql 的 30 分钟链接。”

    为存储桶中的任意文件生成预签名链接，适用于私有存储桶或限时分享。存储桶里的内容不会有任何变化，除非你允许更长，否则链接最长有效 60 分钟。

    工具: create_temporary_link

  • 查看存储桶里的内容

    “我的 Downloads 存储桶里 releases 文件夹有什么？”

    它会列出文件夹和文件，包括不是通过 Aktar 上传的文件。

    工具: list_bucket

设置步骤

  1. 安装 Mac 或 Windows 版 Aktar，并添加一个上传目标（你的存储桶）。在 Aktar 中打开设置 → 集成，开启允许本地连接并复制令牌，然后把它粘贴到这条命令中。需要 Node.js 18 或更高版本。

    npx @getaktar/cli login

  2. 在你的项目中创建 .cursor/mcp.json，内容如下。${workspaceFolder} 就是项目文件夹，所以 Aktar 只从这个项目上传文件。

    在 .cursor/mcp.json 中
    {
  "mcpServers": {
    "aktar": {
      "command": "npx",
      "args": ["-y", "@getaktar/cli", "mcp", "--root", "${workspaceFolder}"]
    }
  }
}

  3. 打开 Cursor 的设置，在 MCP 列表中找到 aktar，确认它已开启。之后智能体就能看到 Aktar 的工具。

要在所有项目中使用 Aktar，把同样的内容放进 ~/.cursor/mcp.json，并把 ${workspaceFolder} 换成一个文件夹，例如 /Users/you/Projects（在 Windows 上为 C:\\Users\\you\\Projects）。要允许更多文件夹，就重复 --root 和文件夹。

因为文件夹是用 --root 指定的，所以不提供直接从剪贴板上传的功能，请改为把文件指给智能体。要让它替换或删除上传的文件，在参数中加上 --allow-replace 或 --allow-delete。如果 Cursor 无法启动 npx，请把 which npx 输出的完整路径填到 command 中。

它能碰什么

文件只来自服务器可以使用的文件夹，SSH 密钥、.env 文件和云服务凭据等机密永远不会被上传。替换和删除上传的文件默认关闭，除非你自己开启。你的存储密钥留在 Aktar 中：智能体拿到的只是文件名和链接，任何内容都不会发给我们。上传的文件对任何拿到链接的人都是公开的，所以只让它上传你想分享的内容。

详情见隐私政策。所有工具和选项都在 MCP 服务器页面上。

收录于:Official MCP RegistryGlamamcpservers.org

常见问题

Cursor 会拿到我的存储密钥吗？

不会。你的密钥留在 Aktar 应用中。服务器只使用 npx @getaktar/cli login 保存在只有你能读取的文件中的本地令牌，并在 127.0.0.1 上与 Aktar 通信。

智能体上传前会先询问吗？

除非你为某个 MCP 工具开启了自动运行，否则 Cursor 在运行它之前会先询问。搜索、列出和临时链接只是查看，上传会修改你的存储桶。

能一次在所有项目中使用吗？

可以。改为把配置放进 ~/.cursor/mcp.json，并在 --root 后面写上允许它上传文件的文件夹。

支持 Windows 吗？

支持，需要 Windows 版 Aktar 0.11.0 或更高版本。在 Mac 上需要 Mac 版 Aktar 0.18.0 或更高版本。

其他 AI 工具