Koru Shield

com.korushieldv1.0.1更新於 Oct 4, 2026

Manage Koru Shield DNS filtering: profiles, rules, categories, schedules, and logs.

已驗證Streamable HTTP可網頁執行Cloud & InfrastructureSecurity & Monitoring

概覽

AI 產生的概覽

讓助理管理 Koru Shield DNS 過濾：設定檔、規則、分類、時間表與查詢記錄。

功能
把 Koru Shield 帳號以 MCP 工具形式開放，用於 DNS 防護管理。工具涵蓋列出與檢視防護設定檔，建立、列出與刪除網域規則，切換成人內容、賭博等過濾分類，模擬某網域目前是否會被封鎖，讀取最近允許與封鎖的 DNS 查詢，查看統計摘要，以及管理時間區間排程。還可列出已註冊裝置、方案權益與用量，以及推薦碼。
適用情境
適合已經使用 Koru Shield、希望用對話方式而非控制台來調整或查看過濾設定的人，例如在小孩的設定檔上封鎖某個網站、檢查某網域目前是否被封鎖、查看今天被封鎖的內容，或新增就寢時間排程。
執行需求
需要 Koru Shield 帳號，以及在控制台建立的 API 金鑰，透過 KORU_SHIELD_API_KEY 環境變數提供，或在 HTTP 傳輸方式下以 Bearer 權杖提供。可連線提供方的遠端端點，也可用 Node.js 透過 npx 在本機執行，不需要安裝步驟。選用環境變數 KORU_SHIELD_API_URL 可覆寫 API 基礎網址。
安裝前請注意
此 API 金鑰擁有 Koru Shield 帳號的完整控制權，包括刪除規則與排程，應像密碼一樣保管，最好使用可獨立撤銷的專用金鑰。相關工具會建立與刪除規則及排程，實際改變裝置的過濾結果。金鑰會傳送給 Koru Shield API。

安裝

在 SourceWeft 中

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

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "koru-shield": {
      "type": "http",
      "url": "https://mcp.korushield.com/mcp"
    }
  }
}

README

Koru Shield MCP Server

Manage your Koru Shield DNS protection through AI assistants. Block domains, check policies, review blocked queries, manage schedules, and more, all through natural language.

What it does

Exposes your Koru Shield account as Model Context Protocol tools:

ToolWhat it does
list_profiles / get_profileList and inspect DNS protection profiles
create_rule / list_rules / delete_ruleBlock or allow domains per profile
list_filter_categories / set_filter_categoryToggle categories (adult, gambling, social media...)
simulate_policyCheck if a domain would be blocked right now
get_logsRecent DNS queries: allowed, blocked, when
analytics_summaryTotals, blocked percentage, encrypted queries
list_schedules / create_schedule / delete_scheduleTime windows (bedtime, homework hours)
list_devicesDevices enrolled per profile
get_entitlementsPlan, limits, current usage
get_referral_codeYour referral link

Example prompts once connected:

  • "Block tiktok.com on the Kids profile"
  • "Would youtube.com be blocked on Kids right now?"
  • "Show me what got blocked today"
  • "Turn on adult content filtering for the whole house"
  • "Add a bedtime schedule 9pm to 7am on weekdays for the Kids profile"

Setup

1. Get a Koru Shield API key

Sign in at https://my.korushield.com, go to API keys, and create one. Copy the key.

2. Install

No install needed. Run directly with npx:

bash
npx -y korushield-mcp-server

Set your key as an environment variable:

bash
export KORU_SHIELD_API_KEY="your-key-here"

Optional: KORU_SHIELD_API_URL overrides the API base URL (default https://my.korushield.com/api).

3. Connect your AI client

Claude Code

bash
claude mcp add koru-shield -- npx -y korushield-mcp-server

(Claude Code passes environment through, so export KORU_SHIELD_API_KEY first. Or use the HTTP transport below with a header.)

Cursor / VS Code

Add to your MCP config (~/.cursor/mcp.json or VS Code mcp.json):

json
{  "mcpServers": {    "koru-shield": {      "command": "npx",      "args": ["-y", "korushield-mcp-server"],      "env": {        "KORU_SHIELD_API_KEY": "your-key-here"      }    }  }}

Claude Desktop

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "koru-shield": {      "command": "npx",      "args": ["-y", "korushield-mcp-server"],      "env": {        "KORU_SHIELD_API_KEY": "your-key-here"      }    }  }}

HTTP transport (remote)

For clients that connect over HTTP (agents, hosted setups):

bash
MCP_TRANSPORT=http PORT=3000 KORU_SHIELD_API_KEY="your-key-here" npx -y korushield-mcp-server

Or pass the key per-request instead of the env var:

POST https://your-host/mcpAuthorization: Bearer <koru-shield-api-key>

Health check: GET /healthz.

Security notes

  • Your API key grants full control of your Koru Shield account, including deleting rules and schedules. Treat it like a password.
  • Prefer a dedicated API key for AI assistants so you can revoke it independently.
  • The server never logs or transmits your key anywhere except to the Koru Shield API.

Development

bash
npm installnpm run buildnpm start

Test with the MCP Inspector:

bash
KORU_SHIELD_API_KEY="your-key-here" npm run inspector

License

MIT

來源：README.md，提交 2907d40

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.1最新Oct 4, 2026