mcpField
S
SkanQRCode

SkanQRCode

本地服务
skanqrcode.com安全03 周前更新
代码仓库访问官网

关于 SkanQRCode

SkanQRCode 是供 AI Agent 在打开或抓取不可信链接前检查 URL 和 IP 安全性的 MCP 服务。它返回风险判定和处置建议，并提供月度额度查询工具。

主要功能

  1. 01检查 URL 或 IP 安全性
  2. 02返回判定、原因与处置建议
  3. 03查询月度额度使用情况
  4. 04支持按用户缓存检查结果

适用场景

  1. 01打开邮件中的链接前进行检查
  2. 02评估聊天或网页提供的 URL
  3. 03阻止 Agent 抓取恶意地址
  4. 04查看检查请求的剩余额度

MCP 相关

该 MCP 服务通过本地 stdio 运行，提供 check_url 和 get_usage 工具。客户端调用检查工具时使用 API 配额，额度查询不消耗配额。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "com-skanqrcode": {
      "command": "npx",
      "args": [
        "-y",
        "@skanqrcode/mcp-server"
      ],
      "env": {
        "SKANQRCODE_API_KEY": "<SKANQRCODE_API_KEY>"
      }
    }
  }
}
启动命令npx -y @skanqrcode/mcp-server
需要配置的环境变量
SKANQRCODE_API_KEY密钥Your SkanQRCode API key (sk_test_... or sk_live_...) from app.skanqrcode.com.

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

安装包
npm@skanqrcode/mcp-server1.0.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@skanqrcode/mcp-server

官方 SkanQRCode MCP 服务。它为 AI Agent 提供 URL 安全检查，让 Agent 在获取、打开或将来自不可信来源的链接提供给用户之前先进行检查。不可信来源包括二维码、电子邮件、聊天消息、网页或其他工具的输出。

它通过 stdio 在本地运行，因此适用于 Claude Desktop、Claude Code、Cursor、Windsurf，以及任何能启动本地进程的其他 MCP 客户端。

设置

  1. 在 app.skanqrcode.com 创建 API 密钥。免费套餐每月提供 1,000 次检查，密钥以 sk_test_ 开头，无需绑定银行卡。
  2. 将此服务添加到 MCP 客户端。

Claude Desktop（claude_desktop_config.json）、Cursor 和大多数其他客户端：

{
  "mcpServers": {
    "skanqrcode": {
      "command": "npx",
      "args": ["-y", "@skanqrcode/mcp-server"],
      "env": { "SKANQRCODE_API_KEY": "sk_test_..." }
    }
  }
}

Claude Code：

claude mcp add skanqrcode --env SKANQRCODE_API_KEY=sk_test_... -- npx -y @skanqrcode/mcp-server

需要 Node.js 20 或更高版本。

工具

check_url

对 URL 或 IP 地址进行分类。输入：

字段必填说明
target是完整的 URL（包含协议）或 IP 地址，最多 4,096 个字符。
userId否此次检查所针对的最终用户的不透明 ID，用于按用户缓存。不得使用电子邮件地址或姓名。

以结构化内容的形式返回 API 的判定结果：

{
  "verdict": "malicious",
  "action": "block",
  "mode": "url",
  "reasons": ["ACTIVE_THREAT_FEED_MATCH", "KNOWN_MALWARE_MATCH"],
  "finalUrl": null,
  "cached": false,
  "executionTimeMs": 38,
  "environment": "production",
  "licensedForProduction": true,
  "requestId": "req_01j9z8qaenp0s2c4d6f8g0h1jk"
}

Agent 应根据 action 作出不同处理：block 表示不要获取或打开该链接，warn 表示先询问用户，allow 表示可以继续。每次调用会消耗每月配额中的 1 次检查。

get_usage

返回每月配额、已使用的请求数和剩余请求数（可选参数 month，格式为 YYYY-MM）。此工具不消耗配额。

错误

调用失败时会返回 isError: true，并附带 { "error": { "code": "...", "message": "...", "requestId": "...", "retryAfterSeconds": 12 } }。 对于 rate_limited，请等待 retryAfterSeconds 指定的时间；对于 quota_exceeded，请停止操作并告知用户。

为什么没有列表工具

此服务为只读服务。Agent 读取的文本可能会试图操控它，而如果 Agent 可以添加允许列表条目，就可能被诱导批准钓鱼域名。请在控制面板中管理允许列表和阻止列表。

环境变量

变量必填默认值
SKANQRCODE_API_KEY是—
SKANQRCODE_BASE_URL否https://api.skanqrcode.com（必须使用 https://）

你的密钥仅会通过 HTTPS 发送至 API，且绝不会被记录。

沙盒密钥

使用以 sk_test_ 开头的密钥时，结果会显示 environment: "sandbox" 和 licensedForProduction: false：判定结果是真实的，但免费套餐仅授权用于测试。请在生产环境中使用付费套餐提供的 sk_live_ 密钥。

开发

npm install
npm test          # unit tests and an MCP client/server round trip
npm run build
SKANQRCODE_API_KEY=sk_test_... npx @modelcontextprotocol/inspector node dist/index.js

API 参考文档：docs.skanqrcode.com。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。