Koru Shield
概览
作者提供的说明(英文原文)
Manage Koru Shield DNS filtering: profiles, rules, categories, schedules, and logs.
它能帮你做什么
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
- 连接方式: 电脑或云端
- 传输方式: stdio, Streamable HTTP
- 分类: 开发者工具
- 你需要填写:KORU_SHIELD_API_KEY
安装
选择你使用的 AI 应用,然后复制设置。
通过 4/5 项检查 · 你的提问会经过开发者的服务器(mcp.korushield.com)
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude · 约 2 分钟
不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个
打开 Claude 的 Connectors 页面
CustomizeConnectors
点击“+ Add” → “Add custom connector”,填写这 2 项
把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue
Name · 名称Koru ShieldRemote MCP server URL · 地址https://mcp.korushield.com/mcpAuthentication 保持 Claude 检测到的设置,然后点击 Add
在聊天中开启
+ConnectorsKoru Shield
试一试
用 Koru Shield 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 Koru Shield,或回答中出现 Koru Shield 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
仅企业版 ChatGPT 可连接
适用于网页版 ChatGPT Business、Enterprise 或 Edu,需由工作区管理员或所有者添加 · 使用 Free、Plus 或 Pro:你的 ChatGPT 方案暂时无法自行连接 MCP
在网页版 ChatGPT 打开添加 MCP 的页面
Plugins+Add custom MCP server
填写名称和地址
输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin
Name · 名称Koru ShieldConnection · 地址https://mcp.korushield.com/mcp在聊天中选择 Koru Shield
开启新聊天,输入前先从插件列表中选择 Koru Shield
试一试
用 Koru Shield 告诉我你能帮我做什么,然后做一件给我看✓ 如果 ChatGPT 说正在使用 Koru Shield,或回答中出现 Koru Shield 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Claude Code · 约 2 分钟
不需要密钥,不用安装程序
打开终端
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
粘贴这条命令并按 Enter
claude mcp add --transport http koru-shield https://mcp.korushield.com/mcp在 Claude Code 中输入 /mcp
应能看到 Koru Shield 在列表中并显示已连接
试一试
用 Koru Shield 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 Koru Shield,或回答中出现 Koru Shield 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor · 约 2 分钟
不需要密钥,不用安装程序
在 Cursor 中以 Agent 模式打开 AI 聊天
试一试
用 Koru Shield 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 Koru Shield,或回答中出现 Koru Shield 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code · 约 2 分钟
不需要密钥,不用安装程序
在 VS Code 中以 Agent 模式打开 AI 聊天
试一试
用 Koru Shield 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 Koru Shield,或回答中出现 Koru Shield 的工具名称,就表示连接成功
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看
通过网页连接的应用使用的地址
https://mcp.korushield.com/mcpJSON 设置在下方“开发者专用”中
开发者专用:终端命令和 JSON 设置
通过网页连接
Claude Code
claude mcp add --transport http koru-shield https://mcp.korushield.com/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"koru-shield": {
"url": "https://mcp.korushield.com/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"koru-shield": {
"type": "http",
"url": "https://mcp.korushield.com/mcp"
}
}
}安装在电脑上
Claude Code
claude mcp add koru-shield --env KORU_SHIELD_API_KEY=your-value -- npx -y korushield-mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"koru-shield": {
"command": "npx",
"args": [
"-y",
"korushield-mcp-server"
],
"env": {
"KORU_SHIELD_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"koru-shield": {
"command": "npx",
"args": [
"-y",
"korushield-mcp-server"
],
"env": {
"KORU_SHIELD_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"koru-shield": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"korushield-mcp-server"
],
"env": {
"KORU_SHIELD_API_KEY": "your-value"
}
}
}
}需要你填写的值
KORU_SHIELD_API_KEY机密 必填 envYour Koru Shield API key (create one in the dashboard at https://my.korushield.com under Settings > API Keys)
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
一览
哪些应用可以使用它
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
通过互联网连接,适用于
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它能做什么
服务器要求先登录,才会列出它的工具。
基础检查i
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月11日
- ✓ 通过
作者与仓库一致
注册名称已通过域名 korushield.com 验证(注册中心会核实域名所有权)
- ✓ 通过
仍在维护
代码最后更新于36天前
- ✓ 通过
有许可证
使用 MIT
- ✓ 通过
端点有响应
在 767 毫秒内响应(HTTP 401)
- ! 注意
- … 尚未检查
工具描述中没有隐藏指令
尚未检查;我们会在检查端点时读取工具列表
讨论
提问、分享技巧或报告无法使用。按“有帮助”数量排序。
用户评价
还没有评价
与“开发者工具”中的其他服务器比较i
- 星标数多于此分类中其他 5748 个服务器的 69%
- 发布到注册中心的时间比此分类中其他 5748 个服务器的 47% 更新
- 基础检查结果等于或优于此分类中其他 5748 个服务器的 30%
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
常见问题
Koru Shield 安全吗?
它在 5 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
它需要哪些密钥或代码?
你需要填写:KORU_SHIELD_API_KEY
它在我的电脑上运行还是在云端?
两种方式都可以:安装在你的电脑上,或者连接云端版本。
它还在维护吗?
GitHub 仓库最后更新于36天前,最新版本(1.0.1)于38天前进入注册中心。
哪些应用可以使用它?
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于支持远程 MCP 的应用,例如 ChatGPT Business 及以上方案。
有什么可以替代它?
同一分类中有:REA, Netdata, Front-End Checklist
替代选择
同一分类中其他作者的服务器,按星标数排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Front-End Checklist
Review frontend code and live pages against 386 quality-gated web development rules.
作者的 README
打开 README
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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:
| Tool | What it does |
|---|---|
list_profiles / get_profile | List and inspect DNS protection profiles |
create_rule / list_rules / delete_rule | Block or allow domains per profile |
list_filter_categories / set_filter_category | Toggle categories (adult, gambling, social media...) |
simulate_policy | Check if a domain would be blocked right now |
get_logs | Recent DNS queries: allowed, blocked, when |
analytics_summary | Totals, blocked percentage, encrypted queries |
list_schedules / create_schedule / delete_schedule | Time windows (bedtime, homework hours) |
list_devices | Devices enrolled per profile |
get_entitlements | Plan, limits, current usage |
get_referral_code | Your 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:
npx -y korushield-mcp-server
Set your key as an environment variable:
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
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):
{
"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:
{
"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):
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/mcp
Authorization: Bearer
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
npm install
npm run build npm start
Test with the MCP Inspector:
KORU_SHIELD_API_KEY="your-key-here" npm run inspector
License
MIT