mcpField
I
ikuai-cli

ikuai-cli

github.com/ikuaidevクラウド・DevOps141283 回インストール10 週間前に更新
リポジトリ

ikuai-cli について

ikuai-cli は、ローカルの iKuai v4.0 HTTP API 経由でルーターを管理する Go 製コマンドラインツールです。運用担当者やエージェント向けに、ネットワーク、セキュリティ、ユーザー、システムの操作と、スクリプト向け出力や dry-run を提供します。

主な機能

  1. 01ルーターの状態とトラフィック確認
  2. 02DNS、DHCP、VLAN、NAT、VPN の管理
  3. 03オンラインユーザーと認証アカウントの管理
  4. 04アクセス制御とフィルターの設定
  5. 05JSON、YAML、dry-run モード

活用シーン

  1. 01ルーターのリソースと通信量の確認
  2. 02ネットワークと VPN の設定
  3. 03オンラインセッションとアクセス制御の管理
  4. 04スクリプトによる一括操作のプレビューと実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ikuaidev/ikuai-cli --skill ikuai-cli

インストール後、Claude Code で/ikuai-cliを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
.golangci.yml
README.md
CONTRIBUTING.md
CODE_OF_CONDUCT.md
.goreleaser.yml
Makefile
SECURITY.md
LICENSE
README_CN.md
.github/
dependabot.yml
pull_request_template.md
.github/ISSUE_TEMPLATE/
feature_request.md
bug_report.md
config.yml
.github/workflows/
codeql.yml
ci.yml
release.yml
cmd/ikuai-cli/
main.go
docs/
cli-reference.md
compatibility.md
install.md
docs/commands/
output.md
docs/examples/
auth-status.pretty.json
auth-status.compact.json
monitor-system.pretty.json
README.md
version.compact.json
users-accounts-list.compact.json
system-set-response.compact.json

詳細

ikuai-cli — AI エージェントスキル

ローカルの v4.0 HTTP API を介して iKuai ルーターを管理する Go CLI です。

使用する場面

  • ルーターのステータス、CPU、メモリ、稼働時間、トラフィック
  • ネットワーク：DNS、DHCP、VLAN、NAT、PPPoE、VPN
  • ユーザー：オンラインセッション、切断、認証アカウント
  • セキュリティ：ACL、MAC フィルター、URL フィルター、ドメインブラックリスト
  • システム：ログ、スケジュール、リモートアクセス、VRRP

前提条件

# Session (persistent)
ikuai-cli auth set-url https://192.168.1.1
ikuai-cli auth set-token <TOKEN>

# OR environment variables (ephemeral)
export IKUAI_CLI_BASE_URL=https://192.168.1.1
export IKUAI_CLI_TOKEN=<TOKEN>

# Verify
ikuai-cli auth status --format json

優先順位： セッションファイル > 環境変数 > なし。

出力モード

フラグモード用途
(デフォルト)table (TTY) / JSON (pipe)人間向け／スクリプトで自動判別
--format jsonコンパクトな JSONエージェントでの解析、jq へのパイプ
--format yamlYAMLLLM でトークンを効率的に使用
--rawAPI エンベロープ全体デバッグ
--human-timeタイムスタンプ → ローカル時刻ログの確認
--dry-runプレビュー、実行なし安全性の確認

ドメイン別スキル

スキルファイル対象範囲
モニターmonitor.mdCPU、メモリ、トラフィック、クライアント
ネットワークnetwork.mdDNS、DHCP、VLAN、NAT、WAN/LAN、PPPoE
セキュリティsecurity.mdACL、MAC、L7、URL、ドメインブラックリスト、peerconn
VPNvpn.mdPPTP、L2TP、OpenVPN、IKEv2、IPSec、WireGuard
ユーザーusers.mdオンラインユーザー、アカウント、パッケージ
システムsystem.md設定、スケジュール、リモートアクセス、VRRP、ALG、カーネル
認証auth.mdログイン、PPPoE 認証アカウント
認証サーバーauth-server.mdWeb ポータルの認証設定
ログlog.mdシステム／DHCP／PPPoE／認証／ARP のログ
オブジェクトobjects.mdIP／IPv6／MAC／ポート／プロトコル／ドメイン／時間オブジェクト
QoSqos.mdIP／MAC 帯域幅制御
ルーティングrouting.md静的ルート、ストリーム振り分け
ワイヤレスwireless.mdブラックリスト、VLAN、AC 管理
詳細設定advanced.mdFTP、HTTP、Samba、SNMPD
バッチbatch.md複数コマンドのワークフロー

コマンドの形式

ikuai-cli <resource> <action> [args] [flags]
  • 読み取り：ikuai-cli monitor system --format json
  • 一覧表示：ikuai-cli network dhcp list --page 1 --page-size 50
  • 書き込み：ikuai-cli network dhcp create --name "Office" --interface lan1 --addr-pool 192.168.1.100-200
  • 書き込み（高度な操作）：ikuai-cli network dns set --data '{"key":"value"}'
  • REPL：ikuai-cli（対話型シェル）

エラー処理

{"code": 3007, "message": "Invalid token"}
コード意味対処方法
3007トークンが無効または期限切れですauth set-token <TOKEN>
1008セッションの有効期限が切れていますauth set-token <TOKEN>
10014権限がありませんユーザー権限を確認してください

コメント

Markdown 対応