koru-shield

Koru Shield MCP サーバー

AI アシスタントを通じてKoru ShieldのDNS保護を管理できます。ドメインのブロック、ポリシーの確認、ブロックされたクエリの確認、スケジュールの管理などを、すべて自然言語で行えます。

できること

Koru ShieldアカウントをModel Context Protocolのツールとして公開します。

ツール	できること
list_profiles / get_profile	DNS保護プロファイルの一覧表示と詳細確認
create_rule / list_rules / delete_rule	プロファイルごとにドメインをブロックまたは許可
list_filter_categories / set_filter_category	カテゴリー（成人向けコンテンツ、ギャンブル、ソーシャルメディアなど）の切り替え
simulate_policy	現時点でドメインがブロックされるか確認
get_logs	最近のDNSクエリ：許可、ブロック、日時
analytics_summary	合計数、ブロック率、暗号化されたクエリ
list_schedules / create_schedule / delete_schedule	時間帯（就寝時間、宿題の時間など）
list_devices	プロファイルごとに登録されたデバイス
get_entitlements	プラン、上限、現在の使用状況
get_referral_code	紹介リンク

接続後に使えるプロンプトの例：

• 「Kidsプロファイルでtiktok.comをブロックして」
• 「今、Kidsでyoutube.comはブロックされますか？」
• 「今日ブロックされたものを見せて」
• 「家全体で成人向けコンテンツのフィルタリングを有効にして」
• 「Kidsプロファイルに、平日の午後9時から午前7時までの就寝時間スケジュールを追加して」

セットアップ

1. Koru Shield APIキーを取得する

https://my.korushield.com にサインインし、API keysに移動してキーを作成します。キーをコピーしてください。

2. インストール

インストールは不要です。npxで直接実行します。

npx -y korushield-mcp-server

環境変数としてキーを設定します。

export KORU_SHIELD_API_KEY="your-key-here"

任意：KORU_SHIELD_API_URLでAPIのベースURLを上書きできます（デフォルトはhttps://my.korushield.com/api）。

3. AIクライアントを接続する

Claude Code

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

（Claude Codeは環境変数を引き継ぐため、先にKORU_SHIELD_API_KEYをエクスポートしてください。または、以下のHTTPトランスポートをヘッダーとともに使用してください。）

Cursor / VS Code

MCP設定ファイル（~/.cursor/mcp.jsonまたはVS Codeのmcp.json）に追加します。

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

Claude Desktop

claude_desktop_config.jsonに追加します。

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

HTTPトランスポート（リモート）

HTTP経由で接続するクライアント（エージェント、ホスト型のセットアップなど）の場合：

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

または、環境変数の代わりに、リクエストごとにキーを渡します。

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

ヘルスチェック：GET /healthz。

セキュリティに関する注意事項

• APIキーを使うと、ルールやスケジュールの削除を含め、Koru Shieldアカウントを完全に操作できます。パスワードと同じように扱ってください。
• AIアシスタント用に専用のAPIキーを用意し、個別に無効化できるようにすることをおすすめします。
• サーバーがキーをログに記録したり、Koru Shield API以外に送信したりすることはありません。

開発

npm install
npm run build
npm start

MCP Inspectorでテストします。

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

ライセンス

MIT