Inspector

io.github.gridinsoft由 GitHub 帳號 gridinsoft 發布v1.0.7更新於 Oct 30, 2026

Website safety and trust analysis. Verify domain reputation and detect phishing with GridinSoft.

已驗證STDIO僅桌面網頁搜尋與抓取安全與監控

概覽

AI 產生的概覽

GridinSoft Inspector 的 MCP 伺服器，讓助理查詢網域信譽、判斷網站是否安全，並掃描 URL 中的釣魚或惡意內容。

可以做什麼
  • 查詢網域的信譽分數、安全判定、分類與報告連結
  • 快速判斷網站是否安全、惡意或詐騙
  • 掃描特定連結或登入頁面，偵測釣魚、惡意軟體與詐騙轉址
  • 查看剩餘 API 額度與訂閱方案狀態
  • 除了 MCP 伺服器，也可透過命令列執行相同的檢查
適用情境
適合在信任某個連結、網域或登入頁之前，先讓助理做核查，或回答關於網站可靠性與安全性的問題。適用於調查、客服與安全初篩等只需信譽查詢的情境。
執行需求
需要 Node.js 22 或更新版本，且 MCP 主機可呼叫 npm/npx；還需透過環境變數 GRIDINSOFT_API_KEY 提供 GridinSoft Inspector API 金鑰。此套件以 stdio 在本機執行，並透過 HTTPS 呼叫 Inspector REST API，因此需要網路存取。URL 掃描最長約 90 秒，建議將用戶端請求逾時設為至少 120 秒。
安裝前請注意
每次查詢都會消耗付費 API 額度（網域檢查 3 點，URL 掃描 10 點；新帳號每月有 100 點免費額度），且轉接層不會自動重試，因為已送出的掃描可能已扣除額度。Unknown 判定表示沒有可用評估，並不代表目標安全。API 金鑰屬於機密，透過 GRIDINSOFT_API_KEY 傳入；送出的網域與 URL 會傳送給 GridinSoft。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Inspector，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@gridinsoft/mcp-inspector

A Model Context Protocol server for domain reputation and URL analysis, powered by GridinSoft Inspector.

Requirements

  • Node.js 22 or newer, with npm/npx available to your MCP host.
  • A GridinSoft Inspector API key from your profile.

The npm package runs locally over stdio and calls the Inspector REST API over HTTPS. https://inspector.gridinsoft.com/mcp is the documentation page; /mcp/v1 is the REST bridge used by this package. Neither URL is a native remote MCP Streamable HTTP or SSE endpoint.

Connect an MCP client

Add this entry to your client's MCP server configuration:

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

Use the configuration location and command transport supported by your MCP host. If it cannot find npx, supply the absolute path to your Node.js installation's npx executable.

URL scans may take up to 90 seconds. Where your client supports it, set its MCP request timeout to at least 120 seconds. The adapter's HTTP timeout defaults to 110 seconds and can be configured with GRIDINSOFT_TIMEOUT_MS (a positive integer in milliseconds). The adapter does not automatically retry requests, because a submitted scan may have already consumed credits. After a timeout, check the Inspector dashboard before submitting it again.

Tools

ToolInputPurposeCredits
inspect_domain{"domain":"example.com"}Available reputation score, verdict, categories, and report link3
check_domain_safety{"domain":"example.com"}Alias for inspect_domain3
get_domain_reputation{"domain":"example.com"}Alias for inspect_domain3
scan_url{"url":"https://example.com/login"}Page metadata and available security signals; additional analysis depends on the plan10
get_balance{}Remaining credits and subscription statusFree

An Unknown verdict means no assessment is available; it does not mean the target is safe. Tool execution errors return isError: true, with an explanation in content. Discovery or prompt/resource failures surface as MCP errors.

Prompts and resources

  • check-website-safety requires the site argument (a URL or domain).
  • verify-domain-trust requires the domain argument.
  • gs://guide/threat-categories describes the security and content categories. A content category alone does not establish malware or fraud.

Example prompt arguments:

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

Command-line use

With GRIDINSOFT_API_KEY set in your environment:

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

Commands print the JSON tool result and exit with a nonzero status on failure. Running without arguments starts the stdio MCP server when launched by a client.

Plans

New accounts receive 100 free API credits per month. See the Inspector dashboard for current plans and pricing.

Development

sh
npm cinpm testnpm run buildnpm pack --dry-run

The tests cover MCP initialization, discovery, prompt argument forwarding, resources, tool aliases, authentication errors, HTTP failures, cancellation, timeouts, stdio framing, and CLI exit codes. An additional backend integration fixture can be run against an Inspector checkout with Composer dependencies installed:

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

This fixture starts a temporary localhost PHP server, uses the real MCP routes/controller, and makes only public or unauthenticated requests. It does not load the application's environment file or perform paid scans.

License

MIT

來源：README.md，提交 31993fc

工具

5

inspect_domain

Domain reputation assessment. Returns the available reputation score (0-100), security verdict, categories, and report link. Unknown means no assessment is available, not that the domain is safe. Use this tool when users ask about site reliability, trust, or safety.

輸入參數domain必填

check_domain_safety

Semantic alias for inspect_domain. Quick check if a website is safe, malicious, or a scam. Returns reputation score and security verdict.

輸入參數domain必填

get_domain_reputation

Semantic alias for inspect_domain. Get the trust and reputation score (0-100) for a domain.

輸入參數domain必填

scan_url

Deep forensic URL analysis. Detects phishing, malware, and fraudulent redirects. Use this to verify specific links, login pages, or suspicious URLs. Returns page metadata and available security signals; additional analysis depends on the subscription plan.

輸入參數url必填

get_balance

Check remaining API credits and subscription plan status

無需輸入參數。

版本歷史

2
  1. v1.0.7最新Oct 22, 2026
  2. v1.0.6Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分