nkmc

すべてのエージェント向けインターネットゲートウェイ。NaKaMiChi - 中道、正しい道。

nkmc により、AI エージェントは API を安全に検出して呼び出し、認証情報インジェクション機能付きで CLI ツールをプロキシ化し、フェデレーテッドゲートウェイネットワークに参加することができます。

インストール: npm install -g @nkmc/cli @nkmc/server

---

クイックリファレンス

# ローカルゲートウェイを開始（キー自動生成、セットアップ不要）
nkmc gateway start

# または公開トンネル付き（ホストされたゲートウェイで自動認証）
nkmc gateway start --tunnel

# API を参照
nkmc ls /                                    # すべてのサービスをリスト
nkmc grep "weather" /                        # サービスを検索
nkmc cat /api.github.com/skill.md            # API 仕様を読む

# API を呼び出し（ゲートウェイが認証情報を自動注入）
nkmc cat /api.github.com/repos/nkmc-ai/gateway
nkmc write /discord.com/channels/123/messages '{"content":"hello"}'
nkmc rm /api.cloudflare.com/zones/z1/dns_records/rec_1

# CLI ツールをプロキシ化（ゲートウェイが環境変数を自動注入）
nkmc run gh repo list
nkmc run stripe customers list --limit 10
nkmc run openai api chat.completions.create -m gpt-4 -p "hello"

# 認証情報を管理（AES-GCM 暗号化されてゲートウェイヴォルトに保存）
nkmc keys set github.com --token ghp_xxx
nkmc keys set api.openai.com --token sk-xxx
nkmc keys list
nkmc keys remove github.com

# 独自のゲートウェイを実行
nkmc gateway start                           # ローカル、ポート 9090
nkmc gateway start --tunnel                  # CF トンネル経由の公開 URL 付き
nkmc gateway start --daemon                  # バックグラウンド
nkmc gateway stop
nkmc gateway status

# サービスを登録（OpenAPI 自動検出）
nkmc register --url http://localhost:3000
nkmc register --url http://localhost:3000 --spec-url http://localhost:3000/openapi.json

# フェデレーション — 他のゲートウェイとピアリング
nkmc peers discover                          # オンラインゲートウェイを検出
nkmc peers discover --domain api.openai.com  # OpenAI を持つゲートウェイを検出
nkmc peers add --id bob --name "Bob" --url https://xyz.tunnel.nkmc.ai --secret xxx
nkmc peers list
nkmc peers remove bob

# 貸出ルール — 共有内容を制御
nkmc rules set api.openai.com --allow --pricing free
nkmc rules set api.stripe.com --allow --pricing per-request --amount 0.01
nkmc rules set github.com --deny
nkmc rules list
nkmc rules remove api.openai.com

# ドメイン検証
nkmc claim api.example.com                   # DNS チャレンジを取得
nkmc claim api.example.com --verify          # 検証して公開トークンを取得

---

コマンド

nkmc auth

ゲートウェイで認証を行い、JWT トークンを ~/.nkmc/credentials.json に保存します。

nkmc auth                                     # ホストされたゲートウェイ（https://nkmc.ai）
nkmc auth --gateway-url http://localhost:9090  # ローカルゲートウェイ

トークンは 24 時間有効です。その後のすべてのコマンドは保存されたトークンを自動的に使用します。

nkmc ls <path>

サービスまたはディレクトリ内容をリスト表示します。

nkmc ls /                        # ネットワーク上のすべてのサービス
nkmc ls /api.github.com/         # 特定のサービスの内容

nkmc cat <path>

仮想パスからデータを読み込みます。

nkmc cat /api.github.com/skill.md
nkmc cat /api.github.com/repos/nkmc-ai/gateway
nkmc cat /rpc.ankr.com/blocks/21000000.json

nkmc grep <pattern> <path>

サービスまたはエンドポイントを検索します。

nkmc grep "weather" /                # すべてのサービスから検索
nkmc grep "alerts" /api.weather.gov/ # サービス内から検索

nkmc write <path> <data>

POST エンドポイントにデータを送信します。

nkmc write /api.cloudflare.com/zones/z1/dns_records '{"type":"A","name":"app","content":"1.2.3.4"}'

nkmc rm <path>

リソースを削除します。

nkmc rm /api.cloudflare.com/zones/z1/dns_records/rec_1abc

nkmc pipe <expression>

2 つのパス間でデータをパイプします。

nkmc pipe 'cat /api.weather.gov/alerts/active | write /discord.com/channels/123/messages'

nkmc run <tool> [args...]

CLI ツールをゲートウェイ経由でプロキシ化します。ゲートウェイはツールの認証情報を検索し、環境変数として注入し、ツールを実行して出力を返します。

nkmc run gh repo list
nkmc run stripe customers list --limit 5
nkmc run aws s3 ls

組み込みツール: gh（GitHub）、stripe、openai、anthropic、aws。

nkmc keys set <domain>

API キーをゲートウェイヴォルトに保存します（AES-GCM 暗号化）。

nkmc keys set github.com --token ghp_xxx
nkmc keys set api.openai.com --token sk-xxx
nkmc keys set api.stripe.com --token sk_test_xxx

nkmc keys list / remove

nkmc keys list                   # 保存されたすべてのキーをリスト
nkmc keys remove github.com      # キーを削除

nkmc gateway start / stop / status

ローカルゲートウェイインスタンスを実行します。

nkmc gateway start                # フォアグラウンド、ポート 9090
nkmc gateway start --port 8080    # カスタムポート
nkmc gateway start --tunnel       # Cloudflare トンネル付き（公開 URL）
nkmc gateway start --daemon       # バックグラウンドモード
nkmc gateway stop                 # バックグラウンドゲートウェイを停止
nkmc gateway status               # 実行状態とトンネル URL を確認

nkmc register

サービスをゲートウェイに登録します。

# 実行中のサービスから自動検出（OpenAPI のよく知られたパスを調査）
nkmc register --url http://localhost:3000

# 明示的な OpenAPI 仕様 URL 付き
nkmc register --url http://localhost:3000 --spec-url http://localhost:3000/docs/openapi.json

# skill.md ファイルから
nkmc register --domain api.example.com --dir ./my-project

nkmc peers

フェデレーション用のピアゲートウェイを管理します。

nkmc peers discover                           # オンラインゲートウェイを検出
nkmc peers discover --domain api.openai.com   # ドメインでフィルタリング
nkmc peers add --id bob --name "Bob" --url https://xyz.tunnel.nkmc.ai --secret shared-key
nkmc peers list
nkmc peers remove bob

nkmc rules

認証情報貸出ルールを管理します。

nkmc rules set api.openai.com --allow --pricing free
nkmc rules set api.stripe.com --allow --peers peer-bob --pricing per-request --amount 0.01
nkmc rules set github.com --deny
nkmc rules list
nkmc rules remove api.openai.com

nkmc claim <domain>

DNS TXT 検証によってドメイン所有権を要求します。

nkmc claim api.example.com          # チャレンジを取得
# TXT レコードを追加: _nkmc.api.example.com → nkmc-verify=xxx
nkmc claim api.example.com --verify # 検証して公開トークンを取得

---

環境変数

変数	説明
NKMC_GATEWAY_URL	ゲートウェイ URL（デフォルト: https://nkmc.ai）
NKMC_TOKEN	エージェント JWT トークン（nkmc auth を推奨）
NKMC_ADMIN_TOKEN	ゲートウェイ管理用の管理者トークン
NKMC_GATEWAY_NAME	トンネル検出用の表示名
NKMC_HOME	設定ディレクトリ（デフォルト: ~/.nkmc）

---

リンク

• GitHub: nkmc-ai/gateway · nkmc-ai/sdk
• npm: @nkmc/cli · @nkmc/core · @nkmc/gateway · @nkmc/server