关于 Averra Extract Mcp
Averra Extract MCP Server 将 AI 客户端连接到 Averra Extract，可把网页转换为附带元数据的整洁 Markdown。它还提供用量查询和 API 密钥管理工具。
主要功能
- 01将 URL 转为 Markdown
- 02附带网页元数据
- 03查询月度用量额度
- 04创建和列出 API 密钥
- 05撤销 API 密钥
适用场景
- 01为 AI 工作流准备网页内容
- 02查看当月剩余请求数
- 03管理账户 API 密钥
MCP 相关
它将 Averra Extract API 的五项操作作为 MCP 工具开放，包括 URL 转换、额度查询和 API 密钥管理。支持 stdio 和 HTTP 传输。
配置
本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。
工具
5收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 要提取内容的网页 URL。接受完整 URL（`https://example.com`）或裸主机名（`example.com` — 自动添加 `https://` 前缀）。最多 2048 个字符。API 会阻止私有/内部 IP。 |
| response_format | enum | 否 | 输出格式：'markdown' 表示便于人类阅读的输出（默认值），'json' 表示机器可读的结构化数据markdown | json |
详细介绍
Averra Extract MCP 服务
适用于 Averra Extract 的 MCP（模型上下文协议）服务，可让 Claude、Cursor 和 ChatGPT 等 AI Agent 将任意网页转换为整洁、适合大模型处理的 Markdown。
已收录于官方 MCP 注册表，标识符为 dev.averra/extract。 支持通过注册表安装的 MCP 客户端可直接使用该标识符；需要手动配置的客户端请参阅下方的安装说明。
功能
将 Averra Extract API 封装为 5 个 MCP 工具：
| 工具 | 描述 |
|---|---|
averra_extract_url | 将任意 URL 转换为带有元数据的整洁 Markdown |
averra_check_usage | 查看每月配额和剩余请求数 |
averra_create_api_key | 创建新的 API 密钥 |
averra_list_api_keys | 列出账户中的所有 API 密钥 |
averra_revoke_api_key | 按 ID 撤销 API 密钥 |
获取 API 密钥
在 averra.dev 注册，免费套餐每月包含 50 次请求。
安装（Claude Desktop）
将以下内容添加到 claude_desktop_config.json：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
重启 Claude Desktop。这 5 个工具将显示在会话中。
安装（Cursor）
添加到 ~/.cursor/mcp.json（或使用 Cursor MCP 设置界面）：
{
"mcpServers": {
"averra-extract": {
"command": "npx",
"args": ["-y", "@averra/extract-mcp"],
"env": {
"AVERRA_EXTRACT_API_KEY": "sk_live_your_key_here"
}
}
}
}
安装（其他 MCP 客户端）
任何基于 stdio 的 MCP 客户端均可使用。将其指向 npx -y @averra/extract-mcp，并在环境中设置 AVERRA_EXTRACT_API_KEY。
配置
| 环境变量 | 必填 | 默认值 | 描述 |
|---|---|---|---|
AVERRA_EXTRACT_API_KEY | 是 | — | 你的 Extract API 密钥（以 sk_live_ 开头） |
AVERRA_EXTRACT_BASE_URL | 否 | https://averra.dev | 覆盖 API 主机 |
TRANSPORT | 否 | stdio | stdio（本地）或 http（托管） |
PORT | 否 | 3000 | TRANSPORT=http 时使用的端口 |
示例提示词（Claude Desktop）
安装后，可以试试：
- “提取 https://example.com 的内容并进行总结”
- “我本月还剩多少 Extract 配额？”
- “阅读 https://docs.anthropic.com/en/docs/intro 并告诉我其中的关键概念”
- “列出我的 Extract API 密钥”
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。