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