@devrobotlabs/visionapi-mcp

用于 Vision API 的 MCP 服务器。将 Claude Code、Claude Desktop、Cursor 或任何其他 MCP 主机指向一个扫描文件夹，然后索取发票——无需编写集成代码，生成的代码中不包含 API 密钥，也不会凭记忆转述合同。

You: pull the totals out of every invoice in ~/inbox and put them in a CSV

Claude: [vision_analyze × 7]
        Done — 7 invoices, 14 credits. Three had no PO number; I left those cells empty.

安装

无需安装。将其添加到主机的配置中，即可通过 npx 运行。

Claude Code — claude mcp add visionapi --env VISION_API_KEY=sk_live_... -- npx -y @devrobotlabs/visionapi-mcp ~/inbox

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "visionapi": {
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "/Users/me/inbox"],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

Cursor — .cursor/mcp.json，格式相同：

{
  "mcpServers": {
    "visionapi": {
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "."],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

VS Code — .vscode/mcp.json：

{
  "servers": {
    "visionapi": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@devrobotlabs/visionapi-mcp", "${workspaceFolder}"],
      "env": { "VISION_API_KEY": "sk_live_..." }
    }
  }
}

在 app.visionapi.io/dashboard/keys 获取密钥。新账户可获得 50 个积分，无需绑定银行卡。

主机配置块直接放在本 README 中，而不是放在 examples/ 目录里——这是对九个客户端库的刻意偏离。只存在于 README 中的代码片段，不会与无人运行的脚本产生漂移。

Related MCP server: receiptconverter-mcp

它可以读取哪些目录

每个位置参数都是服务器可以读取文件的目录。 如果未提供任何参数，则进程工作目录是唯一根目录——这是安全的默认设置，因为 MCP 主机以项目目录作为其 cwd 启动 stdio 服务器。

这一点比看起来更重要。服务器持有实时消费凭证，并以你的文件系统权限运行，因此它可以读取你的 shell 能读取的任何内容。要求它提取 ~/Documents/passport.jpg 的原始文本，是一种将文档内容引入模型上下文以及主机保留的任何转录记录的有效方式。允许列表正是为了防止被误导或被操纵的代理意外执行此类操作。

路径在比较前会通过 realpath 在两侧进行解析，因此允许目录内的符号链接无法指向目录之外。

--allow-any-path 完全关闭允许列表。它会在启动时向 stderr 发出警告，你应该有充分的理由才使用它。

工具

三个消耗积分的工具被标注为 readOnlyHint: false，因此即使主机自动批准只读工具，在运行这些工具之前仍会停下来询问。

目录也以资源形式暴露——visionapi://presets 和 visionapi://presets/{name}——供偏好资源的主机使用。工具是主要接口，因为不同主机对资源的支持程度不一。

输出

响应以模型可读的格式呈现，而不是直接转储 JSON。一个包含 37 个字段的发票预设，如果文档只填满了其中 12 个字段，返回结果将是一个表格加上一行 Not found in this document (25): …，而不是 25 次重复的 {"value":null,"confidence":"low"}——体积缩小三到四倍，也更易于操作。

过程中不会丢失任何信息。每个工具都接受一个 format 参数：

• markdown（默认）——上述渲染格式。

• compact_json——相同的信息以数据形式呈现，包含 _not_found 和 _low_confidence 数组。适用于代理需要解析而非阅读的场景。

• json——API 响应的逐字原样。在编写针对该契约的真实 HTTP 代码时使用。

置信度仅在非高时打印，因此 (mid) 和 (low) 会突出显示，而常见情况则无需额外阅读。

长文档

将 mode 保持为 auto。API 会在 60 秒后终止同步请求；服务器随后会将其重新提交到队列并轮询，同时向主机报告进度。你只会被收费一次，因为超时的尝试已全额释放其预留积分。

对于超过约十页的文档，请预先传递 mode: "async"，并使用 pages: "1-5" 来低成本地抽样长文档——你只需为所选页面付费。

费用与失败

失败不会产生费用。任何非 2xx 响应都会全额释放积分预留，因此失败的调用可以安全地修正和重试，无需清理。工具描述中已说明这一点，因此使用此服务器的代理在出错后会做出合理行为，而不是放弃或重试无法成功的事情。

有两个错误携带的建议值得你自己了解：

环境变量

缺少密钥不会阻止服务器启动：它会在 stderr 上发出警告，tools/list 仍然有效，第一次计费调用会返回一条指明修复方法的消息。拒绝启动的服务器只会告诉用户出了问题。

开发

npm install
npm run typecheck
npm test          # 37 offline tests — no key, no network
npx @modelcontextprotocol/inspector node ./dist/cli.js ~/some/dir

npm install --no-save ../node 用于针对本地构建的客户端进行测试。不要使用 npm install ../node——那会将 package.json 重写为 "file:../node"，而该清单文件正是发布的内容。

链接

• 文档

• 面向编码代理的集成参考

• 预设目录

• 定价

MIT 许可。