Website Reputation Checker

@gridinsoft/mcp-inspector

一个用于域名信誉和 URL 分析的 Model Context Protocol 服务，由 GridinSoft Inspector 提供支持。

要求

• Node.js 22 或更高版本，且 MCP 主机可使用 npm/npx。
• 从你的 个人资料 获取 GridinSoft Inspector API 密钥。

npm 包通过 stdio 在本地运行，并通过 HTTPS 调用 Inspector REST API。https://inspector.gridinsoft.com/mcp 是文档页面；/mcp/v1 是此软件包使用的 REST 桥接接口。这两个 URL 都不是原生的远程 MCP Streamable HTTP 或 SSE 端点。

连接 MCP 客户端

将以下条目添加到客户端的 MCP 服务配置中：

{
  "mcpServers": {
    "gridinsoft": {
      "command": "npx",
      "args": ["-y", "@gridinsoft/mcp-inspector"],
      "env": {
        "GRIDINSOFT_API_KEY": "your_api_key_here"
      }
    }
  }
}

请使用 MCP 主机支持的配置位置和命令传输方式。如果找不到 npx，请提供 Node.js 安装目录中 npx 可执行文件的绝对路径。

URL 扫描最长可能需要 90 秒。如果客户端支持，请将其 MCP 请求超时设为至少 120 秒。适配器的 HTTP 超时默认为 110 秒，可通过 GRIDINSOFT_TIMEOUT_MS（以毫秒为单位的正整数）配置。适配器不会自动重试请求，因为已提交的扫描可能已经扣除额度。超时后，请先检查 Inspector 控制面板，再重新提交。

工具

工具	输入	用途	额度
inspect_domain	{"domain":"example.com"}	可用的信誉评分、判定、类别和报告链接	3
check_domain_safety	{"domain":"example.com"}	inspect_domain 的别名	3
get_domain_reputation	{"domain":"example.com"}	inspect_domain 的别名	3
scan_url	{"url":"https://example.com/login"}	页面元数据和可用的安全信号；额外分析取决于套餐	10
get_balance	{}	剩余额度和订阅状态	免费

Unknown 判定表示没有可用的评估结果；这并不意味着目标是安全的。工具执行错误会返回 isError: true，并在 content 中提供说明。发现、提示词或资源失败则会作为 MCP 错误呈现。

提示词和资源

• check-website-safety 需要 site 参数（URL 或域名）。
• verify-domain-trust 需要 domain 参数。
• gs://guide/threat-categories 介绍安全和内容类别。仅凭内容类别无法判定存在恶意软件或欺诈行为。

提示词参数示例：

{
  "name": "check-website-safety",
  "arguments": { "site": "https://example.com" }
}

命令行用法

在环境中设置 GRIDINSOFT_API_KEY 后：

npx -y @gridinsoft/mcp-inspector check example.com
npx -y @gridinsoft/mcp-inspector inspect example.com
npx -y @gridinsoft/mcp-inspector scan https://example.com/login
npx -y @gridinsoft/mcp-inspector --help

命令会输出 JSON 工具结果，并在失败时以非零状态退出。无参数运行时，如果由客户端启动，则会启动 stdio MCP 服务。

套餐

新账户每月可获得 100 个免费 API 额度。当前套餐和价格请查看 Inspector 控制面板。

开发

npm ci
npm test
npm run build
npm pack --dry-run

测试涵盖 MCP 初始化、发现、提示词参数转发、资源、工具别名、身份验证错误、HTTP 故障、取消、超时、stdio 帧处理和 CLI 退出代码。还可以使用安装了 Composer 依赖的 Inspector 代码库运行额外的后端集成测试夹具：

INSPECTOR_TEST_ROOT=/absolute/path/to/inspector node --test test/php-integration.cjs

此测试夹具会启动一个临时的 localhost PHP 服务，使用真实的 MCP 路由和控制器，并且只发起公开或无需身份验证的请求。它不会加载应用程序的环境文件，也不会执行付费扫描。

许可证

MIT