BiGapi — file operations for AI agents

Name: BiGapi — file operations for AI agents
Author: BiGapi-2026

已认证精选本地服务

github.com/BiGapi-2026生产力06 周前更新

代码仓库

关于 BiGapi — file operations for AI agents

BiGapi 的 MCP 服务通过远程 API 执行文件处理操作，面向需要将 Agent 输出转换为文件或读取文件的场景。它涵盖 PDF、文档、网页、图像和文本处理，并可按需加载专用工具。

主要功能

01处理 PDF 合并、拆分、脱敏和转换
02转换 Office 文档、电子书及 Markdown
03将 HTML、Markdown 或 URL 渲染为 PDF 或 PNG
04调整、压缩和转换图像
05按需启用工具或通过 run_operation 执行操作
06提供 OCR、签名验证和文本分块

适用场景

01将 Markdown 或网页渲染为 PDF
02从 PDF 中提取表格或执行 OCR
03整理文档并转换为所需格式
04为 RAG 准备分块文本

MCP 相关

该 MCP 服务向 MCP 客户端提供 find_tool、run_operation、enable_tools 等工具，调用 bigapi.dev 执行 40 多种文件操作。初始仅列出少量工具，也可按需启用专用工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "bigapi-file-operations-for-ai-agents": {
      "command": "npx",
      "args": [
        "-y",
        "@bigapi/mcp"
      ],
      "env": {
        "BIGAPI_KEY": "<BIGAPI_KEY>"
      }
    }
  }
}

启动命令npx -y @bigapi/mcp

需要配置的环境变量

BIGAPI_KEY密钥Optional API key (otherwise call the get_access tool)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@bigapi/mcp0.8.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	返回的候选项数量
query	string	是	用通俗语言描述的任务，例如“将 png 转换为 webp”

详细介绍

@bigapi/mcp

适用于 bigapi.dev 的 MCP 服务——AI Agent 的输出层。

你的 Agent 生成了内容。bigapi 会将其转换为完整文件，也能读取文件内容。合并、脱敏、OCR、转换、签名、验证：这些是大模型无法自行完成的操作，通过纯 HTTPS 即可实现，只需一个密钥，无需在服务端安装任何东西。

**每次操作 0.01 美元。赠送 100 次免费操作。免费操作和余额永不过期。失败的调用免费。**服务器位于德国，符合 GDPR 要求，文件在交付后删除。每项操作都附有公开发布的证明，证实其确实能兑现承诺。

也已在官方 MCP Registry 中列出，名称为 dev.bigapi/mcp。

默认精简

服务启动时保持精简：只列出五个工具，因此不会占用你的上下文。

工具	功能
`find_tool`	用通俗语言描述任务，获取匹配的操作及可直接运行的示例。免费，无需密钥。
`run_operation`	按名称运行任意 bigapi 操作，包括在客户端启动后新增的操作。
`enable_tools`	按需加载专用工具，例如 `["pdf_redact","ocr"]` 或 `["all"]`。
`get_access` / `get_balance`	获取免费密钥、查询余额。

从启动的第一秒起，所有 40 多项操作都可通过 run_operation 使用；专用工具只是为了方便，并非必需。想立即查看完整列表？在服务环境中设置 BIGAPI_TOOLS=all。

原因：每个工具定义都会占用客户端的上下文，而模型在五条描述中进行选择，比扫描四十六条更容易选对。

可运行的操作

所有 40 多项操作都可通过 run_operation（或启用 enable_tools 后使用对应的专用工具）运行。无需记住此列表，只需用通俗语言询问 find_tool：

PDF 基础操作——合并、拆分、旋转、压缩、页面信息、目录、比较、线性化
PDF 内容处理——转换为 Markdown、转换为图像、提取表格、提取附件（ZUGFeRD / Factur-X 发票 XML）
PDF 安全——脱敏（栅格化并重建，可证明文本已彻底移除）、清理（JavaScript、操作、嵌入文件）、设置或移除密码、验证签名
PDF 归档——转换为 PDF/A-2b，嵌入字体并设置输出意图，通过 veraPDF 检查
文档——将 Office 文档和电子书转换为 PDF 或 Markdown（DOCX、XLSX、PPTX、ODT、EPUB），将 Markdown 转换为 Word，将 .eml 转换为 PDF
网页与渲染——将 HTML/Markdown/URL 转换为 PDF 或 PNG，使用设备预设截取整页屏幕截图，将 HTML 或 URL 转换为整洁的 Markdown，Handlebars 模板、图表、二维码
图像——调整大小、裁剪、转换（WebP/AVIF/…）、压缩、移除元数据、添加水印、图像信息
AI 透明度——使用 C2PA Content Credentials 签名和验证，添加可见的“AI 生成”标签并标记 EXIF（《欧盟 AI 法案》第 50 条）
RAG 文本处理——基于 Token 分块，识别标题，并支持重叠
账户——免费密钥、余额、使用量、月度限额、定价

安装

需要 Node 18+。初始阶段无需 API 密钥——Agent 可以自行调用 get_access。

Claude Desktop

claude_desktop_config.json（设置 → 开发者 → 编辑配置）：

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

重启 Claude Desktop。然后说：“获取 bigapi 访问权限，并将这段文本渲染为 PDF 保存到我的桌面。”

Cursor / Windsurf / Cline

在相应的 MCP 设置中使用相同的配置块（.cursor/mcp.json、~/.codeium/windsurf/mcp_config.json、Cline → MCP 服务器 → 配置）。

使用现有密钥

"bigapi": { "command": "npx", "args": ["-y", "@bigapi/mcp"], "env": { "BIGAPI_KEY": "bigapi_..." } }

文件处理方式

输入使用本地路径（/Users/me/report.pdf、C:\Users\me\scan.pdf）。如果提供了 output_path，输出将写入该路径；否则会写入临时文件夹（可通过 BIGAPI_OUTPUT_DIR 修改）。每个结果都会包含费用、扣费来源以及剩余余额。

定价

统一按 $0.01/次操作 收费——每次操作均如此，无一例外（ocr、office_to_pdf、pdf_to_markdown、pdf_extract_tables、pdf_compare 和 pdf_redact 按页计费）。预付金额最低为 $5——无订阅、无需注册、余额永不过期，失败的调用免费。可通过 get_pricing 或 GET /v1/pricing 以机器可读的方式获取。

环境

变量	默认值	用途
`BIGAPI_KEY`	–	使用此密钥代替已存储的密钥
`BIGAPI_CONFIG_DIR`	`~/.bigapi`	`get_access` 存储密钥的位置（`config.json`，权限模式为 600）
`BIGAPI_OUTPUT_DIR`	OS 临时目录	默认输出文件夹
`BIGAPI_URL`	`https://api.bigapi.dev`	API 基础地址（用于自托管 / 测试）

不使用 MCP

纯 HTTP 可在任何环境中使用（n8n、Make、Zapier、LangChain 或你自己的代码）：

curl -X POST https://api.bigapi.dev/v1/keys                       # → key
curl -o out.pdf https://api.bigapi.dev/v1/render \
  -H "Authorization: Bearer $KEY" -H "content-type: application/json" \
  -d '{"markdown":"# Hello from an agent"}'

OpenAPI：https://api.bigapi.dev/openapi.json · 文档：https://api.bigapi.dev/docs · 指南：https://bigapi.dev/guides/ · llms.txt：https://api.bigapi.dev/llms.txt