Allscreenshots

Allscreenshots 插件

通过 Allscreenshots API，在 Claude Code、OpenAI Codex 和任何兼容 MCP 的客户端中截取网站屏幕截图。

支持的平台

• Claude Code
• OpenAI Codex
• 兼容 MCP 的客户端，例如 Cursor、VS Code Copilot、Gemini CLI 和 Windsurf

快速安装

Claude Code

添加 Allscreenshots 市场，然后安装插件：

/plugin marketplace add allscreenshots/allscreenshots-plugin
/plugin install allscreenshots@allscreenshots

安装后重启 Claude Code。Claude Code 市场会从 claude-code-plugin/ 安装一个小型插件包。

如果你已安装旧版本，而 Claude Code 仍报告插件缓存错误，请刷新市场并更新插件：

/plugin marketplace update allscreenshots
/plugin update allscreenshots@allscreenshots

OpenAI Codex

添加 Allscreenshots 市场，然后从 Codex 的插件目录安装插件：

codex plugin marketplace add allscreenshots/allscreenshots-plugin
codex
/plugins

选择 Allscreenshots 市场，打开 Allscreenshots 插件并安装。该插件包含 MCP 服务配置，因此你无需粘贴冗长的 codex mcp add 命令。

如果你已安装旧版本，请先刷新市场：

codex plugin marketplace upgrade allscreenshots

通用 MCP 客户端

将 MCP 客户端配置为运行：

python3 /path/to/allscreenshots-plugin/mcp_server/server.py

在 MCP 服务环境中设置 API 密钥，或通过工具参数 api_key 传入。

配置

从以下位置获取 API 密钥：

https://allscreenshots.com/dashboard

然后将其设置为环境变量：

export ALLSCREENSHOTS_API_KEY=your-key-here

调用 take_screenshot 时，也可以通过 api_key 参数直接传入 API 密钥。

当 ALLSCREENSHOTS_API_KEY 变量对 MCP 子进程可见时，MCP 服务会读取该变量。调用 take_screenshot 时，也可以通过 api_key 参数直接传入 API 密钥。

如果无法使用 MCP 工具，也可以直接通过 curl 调用 Allscreenshots REST API；无需安装 Allscreenshots CLI。

可用工具

工具	描述	参数
take_screenshot	截取网站屏幕截图，并返回保存后的本地文件路径。	url、api_key、width、height、format、full_page、delay、dark_mode、block_ads
get_api_info	返回设置链接、支持的格式、速率限制说明和 API 密钥指引。	无

示例

• “截取 https://example.com 的屏幕截图”
• “截取我们着陆页的整页屏幕截图”
• “以深色模式截取此页面”
• “截取 https://example.com 的移动版屏幕截图”
• “截取不带广告或 Cookie 横幅的屏幕截图”
• “如何获取 Allscreenshots API 密钥？”

开发

官方 MCP 注册表

托管的 MCP 服务已注册为 com.allscreenshots/allscreenshots：

https://registry.modelcontextprotocol.io/v0.1/servers/com.allscreenshots%2Fallscreenshots/versions/latest

server.json 是发布清单。端点仍为 https://mcp.allscreenshots.com/mcp/v1，支持通过 OAuth 登录或使用可选的 X-API-Key 请求头。

要发布更新版本，请提升 server.json 中的 version，提交更改，然后运行 Publish to MCP registry 工作流。该工作流通过 https://allscreenshots.com/.well-known/mcp-registry-auth 验证所有权。对应的 Ed25519 私钥种子保存在仓库机密 MCP_REGISTRY_PRIVATE_KEY 中；切勿 提交该密钥。GitHub OIDC 身份验证仅授予 io.github.* 命名空间的权限， 无法发布基于域名的名称。

命名空间迁移于 2026 年 11 月 1 日发布。旧版 io.github.allscreenshots/allscreenshots 条目已从发现结果中移除，因为注册表规定一个端点 URL 只能属于一个服务名称。 其历史元数据仍会保留。我们已将新条目发送给 Glama 支持团队，以供审核现有列表的迁移事宜。客户端端点配置 无需更改。

在本地运行 MCP 服务：

cd mcp_server
export ALLSCREENSHOTS_API_KEY=test-key
python3 server.py

运行测试：

uv run --with "fastmcp>=2.0" --with "httpx>=0.27" --with "pytest>=8" pytest

打包 Claude Code 和 Codex 插件发行包：

python3 scripts/package_plugins.py

归档文件将写入 dist/。

检查 Codex 市场元数据：

codex plugin marketplace add ./path/to/allscreenshots-plugin
codex
/plugins

许可证

MIT