CaptureKit

CaptureKit MCP 服务

面向 CaptureKit 截图 API 的官方 Model Context Protocol 服务。

将网站捕获为 PNG、JPEG、WebP 或 PDF，提取其内容，或使用 AI 分析网站。

它支持 Claude、Cursor、VS Code、Windsurf 以及任何 MCP 客户端将 API 作为工具调用。支持通过 stdio（本地）或 Streamable HTTP（可自托管）运行。

要求

• Node.js 20 或更高版本
• CaptureKit API 密钥 — 注册，然后从控制面板复制密钥

托管服务（推荐）

CaptureKit 会为你运行此服务，地址为 https://mcp.capturekit.dev/（Streamable HTTP）。在 x-api-key 标头中发送你的 API 密钥；无需安装任何内容。

claude mcp add --transport http capturekit https://mcp.capturekit.dev/ --header "x-api-key: YOUR_API_KEY"

{
  "mcpServers": {
    "capturekit": {
      "url": "https://mcp.capturekit.dev/",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

托管服务与此软件包提供相同的 API；如果你需要使用 stdio、自定义网络出口或自托管，请在本地运行此软件包。

在本地运行

Claude Code

claude mcp add capturekit --env CAPTUREKIT_API_KEY=YOUR_API_KEY -- npx -y @capturekitdev/mcp

Claude Desktop、Cursor、Windsurf 和其他客户端

将服务添加到客户端的 MCP 配置（claude_desktop_config.json、.cursor/mcp.json……）：

{
  "mcpServers": {
    "capturekit": {
      "command": "npx",
      "args": ["-y", "@capturekitdev/mcp"],
      "env": {
        "CAPTUREKIT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

VS Code

{
  "servers": {
    "capturekit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@capturekitdev/mcp"],
      "env": {
        "CAPTUREKIT_API_KEY": "${input:capturekit-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "capturekit-api-key",
      "description": "CaptureKit API key",
      "password": true
    }
  ]
}

Claude Desktop 扩展

从发布页面下载 .mcpb 包并打开；Claude Desktop 会提示你输入 API 密钥。

Docker

docker build -t capturekit-mcp .
docker run -i --rm -e CAPTUREKIT_API_KEY=YOUR_API_KEY capturekit-mcp

工具

工具	描述
analyze	AI 内容 API 可分析任意网页，并返回 AI 洞察摘要、价值主张、功能、类别、用例，以及可选的联系信息。
capture	类似浏览器的截图 API，可将网页捕获为 PNG/JPEG/WebP 或 PDF，用于预览、QA、报告、监控和归档，无需配置无头浏览器。
content	CaptureKit 内容 API 可提取结构化网页数据、元数据、链接、HTML/Markdown：一次请求即可满足 SEO、监控、索引和自动化需求。
stats	查看过去一小时内某个引擎或端点的基础设施运行状况。数据不限定于你的账户或租户。需按账户启用：HTTP 403 表示请联系支持团队开通。
usage	获取 CaptureKit 账户的实时用量统计和额度余额。
website_crawler	网站爬虫 API 可在请求模式（不进行渲染）下获取任意网页的原始 HTML，适用于快速抓取、审计、监控以及链接/元数据提取。

每个调用 API 的工具都会消耗额度。JSON 结果以文本形式返回；图片会直接内嵌返回，其他文件（PDF……）则作为嵌入式资源返回，最大 4 MB。

Streamable HTTP

npx @capturekitdev/mcp --http --port 3000

端点为 POST /mcp（无状态，返回 JSON）。每个客户端都在 x-api-key 标头（或 Authorization: Bearer <key>）中发送自己的密钥；服务本身不会使用自己的密钥。默认绑定到 127.0.0.1，并会拒绝浏览器来源，除非你允许这些来源——对外开放前，请将其置于 TLS 后面。

为兼容 Fetch 的运行时（Cloudflare Workers、Deno、Bun）导出了 createHttpHandler()：

import { createHttpHandler } from "@capturekitdev/mcp";

export default { fetch: createHttpHandler({ allowedOrigins: [] }) };

安全

• 从 CAPTUREKIT_API_KEY（stdio）或请求标头（HTTP）读取 API 密钥，并从错误消息中移除。
• 从网站获取的内容不可信：服务指令会告知模型将其视为数据，而不是指令。
• 请参阅 SECURITY.md 以报告漏洞。

开发

npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js

基于 SDK 构建

该服务使用官方的 Node.js SDK（@capturekitdev/sdk）。

所有 CaptureKit SDK

SDK	Package	安装
Node.js	@capturekitdev/sdk	npm install @capturekitdev/sdk
Python	capturekitdev	pip install capturekitdev
Go	capturekit-go	go get github.com/capturekitdev/capturekit-go
.NET	CaptureKit	dotnet add package CaptureKit
Ruby	capturekitdev	gem install capturekitdev
PHP	capturekitdev/sdk	composer require capturekitdev/sdk
Java	capturekit-java	从源代码构建，请参阅其 README
CLI	@capturekitdev/cli	npm install -g @capturekitdev/cli
MCP 服务	@capturekitdev/mcp	npx -y @capturekitdev/mcp

许可证

MIT — 参见 LICENSE。