Kura（蔵 — 宝物を守る倉）

AIエージェントのためのローカルEVMウォレット。 MacでClaudeのようなAIがインターネット決済（x402）をするとき、人間がパスワードで承認するウォレットです。

• 人間用ウォレット（MetaMaskなど）ではなくAIエージェント用

• クラウドSaaSではない — ローカルのみで動作します。鍵はこのコンピュータから出て行きません。

• AIが決済を要求 → 人間がパスワードで承認 → 実行

• チェーンはBase（イーサリアムL2、手数料ほぼゼロ）。デフォルトはテストネット（Base Sepolia）

一目でわかる

[ AI 앱 (Claude Code / 데스크톱) ]
        │  MCP로 "결제해줘" 요청
        ▼
[ Kura 데스크톱 앱 ]  ← 승인 팝업 → 사람이 비밀번호 입력
        │  서명 (키는 이 앱 안에서만)
        ▼
[ Base 체인 / x402 페이실리테이터 ]  ← 실제 결제

パスワードはKuraアプリの入力欄でのみ受け付けます。チャット画面・MCP・設定ファイルのどこにも入りません。

Related MCP server: cardzero-mcp

インストール

Apple Silicon Mac（macOS 11以上）

(A) Homebrew

brew install --cask dinggi5/tap/kura

(B) DMGを直接ダウンロード

ReleasesからKura_<バージョン>_aarch64.dmgをダウンロードして開き、KuraをApplicationsフォルダにドラッグ＆ドロップしてください。

鍵を預けるアプリなので、受け取ったアプリが本当に私が作ったものか確認する方法はSECURITY.mdにコマンドまで書いてあります。

(C) ソースからビルド

事前準備: Rust、Node.js（20.19+ または 22.12+ — Vite 7が必要）、macOS。

git clone https://github.com/dinggi5/kura.git
cd kura
git checkout v0.1.1   # 배포본과 같은 소스. 빼면 개발 중인 최신 코드가 받아져요
npm ci                # package-lock.json 그대로 설치 (install 은 버전이 올라갈 수 있어요)

# 개발 모드로 바로 실행
npm run tauri dev

# 앱으로 빌드해 /Applications에 설치
npm run tauri build -- --bundles app --no-sign
ditto src-tauri/target/release/bundle/macos/Kura.app /Applications/Kura.app
open /Applications/Kura.app

アップデート

アプリが自動でアップデートします。
設定 → 情報でバージョンと変更内容を確認し、今すぐインストールして再起動を押してください。

• 確認だけが自動で、インストールは常に自分で押す必要があります。

• 受け取ったファイルは署名が正しいか検証した後でのみインストールされます（署名検証は無効にできません）。詳細はSECURITY.mdの「アップデート」節に書いてあります。

• 自動アップデート確認の通信が嫌なら設定 → 情報 → 起動時に確認をオフにしてください。

削除

⚠️ アプリを削除してもウォレットは削除されません。 鍵・設定・取引履歴はアプリの外の~/.jigapフォルダにあるため、アプリだけ削除するとそのまま残ります — うっかり資産を失わないように意図的にそうしています（brew uninstall --zapでも削除されません）。

# 앱만 제거 (지갑은 남음 — 나중에 다시 설치하면 그대로 이어서 써요)
brew uninstall --cask dinggi5/tap/kura   # 또는 /Applications/Kura.app 을 휴지통으로

このMacでウォレットまで完全に削除するには、順序を必ず守ってください:

1. 12語のリカバリーフレーズが手元にあるか先に確認してください。 アプリのヘッダーの鍵ボタンから再度確認できます。

2. 残高が残っているなら他のウォレットに移してください。

3. Kuraを完全に終了してください（メニューバーアイコンを右クリック → 終了）。起動していると数秒ごとに~/.jigapに状態ファイルを書き込むため、削除したフォルダがすぐに再作成されます。

4. Kura MCPを接続しているAIツール（Claude Codeなど）も終了してください。

5. 自動起動をオンにしていたらオフにするか、rm ~/Library/LaunchAgents/Kura.plist（アプリをゴミ箱に捨ててもこのファイルは残ります。brew uninstall --caskで削除すると一緒に削除されます）。

6. そのあとにrm -rf ~/.jigap

12語なしで最後のrm -rf ~/.jigapを実行すると、そのウォレットの資産は誰にも取り戻せません。

初回起動

Kuraはメニューバーに常駐します。 起動すると画面上部のメニューバーに倉のアイコン（◻︎）が表示され、ウィンドウはそのアイコンをクリックしたときだけ下に展開されます。他の場所をクリックすると閉じ、アプリはバックグラウンドに残ってAIの決済要求を待ち続けます。完全に終了するにはアイコンを右クリック → 終了。（ウォレットがまだない初回起動時はウィンドウが自動で開きます。）

1. ウォレット作成 — 送金のたびに入力するパスワード（8文字以上）を決めます。このパスワードで鍵が暗号化されて保存されます（~/.jigap/wallet.enc）。

2. シードのバックアップ — 12語が表示されます。これが資産の本当の所有証明なので、紙やパスワードマネージャーに書き留めてください。パスワードを忘れても12語があれば取り戻せます: アプリを終了し、12語が手元にあるか先に確認したうえで、~/.jigap/wallet.encを削除してアプリを再起動すると、最初の画面のインポートで復元できます（他の標準BIP-39ウォレットに入れても構いません）。ただし、12語なしでこのファイルを削除すると資産を永遠に失います。

3. ウェルカムツアー — チャージ・AI接続・安全装置を説明します。ヘッダーの**ⓘ ヘルプ**からいつでも再度見られます。

資金を入れる（USDC）

決済するにはウォレットにUSDC（デジタルドル）が必要です。

• アプリで受け取りを押すとアドレスとQRが表示されます。

• 取引所・他のウォレットから送る際は必ずBaseネットワークを選択してください。他のネットワークに送ると資金を失います。

• **テストネット（デフォルト）**では本物のお金ではありません。受け取り画面のFaucetボタンで無料のテストコインを受け取って練習してください。

• ETHは任意です — x402決済は手数料をペイフェシリテーターが代わりに支払うため、ETHが0でも大丈夫です。アプリの送金で直接送金するときだけガス用のETHが少し必要です（Baseの手数料は1セント前後）。チャージはUSDCだけで十分です。

AI（Claude）に接続する

AIアプリのMCP設定にKuraサーバーを登録すると接続されます。接続されるとメイン画面に**「Claude接続済み」バッジが表示されます。0.1.2からはアプリ内にMCPサーバーが組み込まれているため**、ソースのクローンやRustのインストールなしで接続できます。

一番簡単な方法 — アプリ内の「AI接続」画面

メイン画面上部の**「AI未接続」バッジをクリックすると**接続画面が開きます。

• Claudeデスクトップ — 「接続」ボタンを押すとClaudeに拡張機能のインストール画面が表示されます。「インストール」を押すだけです。

• Claude Code — ボタン一つで登録されます（claude mcp addをアプリが代わりに実行）。次のclaude起動からどのフォルダでも接続されます。

以下は同じことを手動で行う方法です。

Claudeデスクトップ — 拡張ファイル一つで完了

リリースページからkura-<バージョン>.mcpbをダウンロードしてダブルクリックすると、Claudeデスクトップがインストールを確認してきます。（またはClaude設定 → 拡張機能 → ファイルを選択。）

拡張機能の中に実行ファイルはありません — インストール済みのKura.app内の署名・公証済みMCPサーバーを署名確認後に実行するランチャーだけが入っています。そのためKuraアプリを先にインストールする必要があります。

Claude Code・他のMCPアプリ

アプリ内のバイナリを絶対パスで登録すればいいです:

claude mcp add --scope user kura -- /Applications/Kura.app/Contents/MacOS/kura-mcp

（--scope userは「このフォルダだけ」ではなくどこでも使えるようにするオプションです。1つのプロジェクトだけで使うなら外しても構いません。）

他のMCPアプリは設定に以下のように記述します:

{
  "mcpServers": {
    "kura": {
      "command": "/Applications/Kura.app/Contents/MacOS/kura-mcp"
    }
  }
}

ソースから開発中の場合

リポジトリルートの.mcp.jsonがすでに入っています。このフォルダでclaudeを実行すると自動で認識されます（最初にサーバーを使うか聞かれるので承認してください）。このパスはcargo runで毎回新しくビルドする開発用です — インストールして使う場合は上記のアプリパス登録が正しいです。

AIが使えるツール: get_wallet_status・get_balances・get_history（読み取り専用）・request_payment（決済要求 → アプリの承認ポップアップ）・x402_fetch（402決済がかかったURLを呼び出し）。

MCPツールを変更したらAIアプリを再起動する必要があります（サーバーはセッション開始時に1回ロードされます）。

決済はこう流れます

1. AIが決済を要求します。

2. Kuraのウィンドウが表示され、いくらを、どこへ送るのかを見せます（ウィンドウが隠れていても自動で表示されます）。

3. パスワードを入力して承認します。

4. 決済が実行され、結果がAIに返ります。5分以内に承認しないと自動拒否。

セキュリティモデル

• パスワード承認 — デフォルトは毎回の決済でパスワード承認です（自動決済をオンにすると以下の条件でのみ例外）。鍵は暗号化（Argon2id + AES-256-GCM）されて保存され、決済するときだけ復号化してすぐ消去します（自動決済セッションをオンにすると、ロック解除中のみメモリに保持）。

• 限度額 — 1回に/1日にいくらまで送れるかを設定で決めます（デフォルト単一5・日次20 USDC）。超えるとブロックされます。

• 緊急ロック — ヘッダーのシールドボタンをオンにすると、すべての送金が即座にブロックされます。

• 信頼アドレス・自動決済 — パスワードなしで自動承認するにはセッションロック解除 + 少額限度 + 信頼アドレスの3つすべてが揃わなければなりません。それ以外は常にパスワード。

• 取引履歴 — 送った送金・ブロックされた試行・署名をすべて記録します。

• ローカル優先 — 鍵（~/.jigap/）はリポジトリの外にあり、gitに上がりません。

• 分析・フォントCDNなし — アプリが自らインターネットに接続するのは3つだけです。①残高照会・送金に使うRPCサーバー ②AIが要求したx402アドレス ③アップデート確認（GitHub）。使用履歴はどこにも送信されず、フォントもアプリ内に入っているのでオフラインでも画面はそのまま表示されます。

• アップデート確認はオフにできます — アプリ起動時にGitHubへ新しいバージョンがあるか問い合わせます（そこには接続IPと現在のバージョンが残ります）。設定 → 情報 → 起動時に確認でオフにするとこの通信もなくなります。確認をオンにしていてもオフにしていても、インストールは自分で押さないと進みません — こっそり変更されることはありません。

開発者向け

CLIのkuraでも同じウォレットを操作できます（MCPサーバーとコアロジックを共有）。インストール済みアプリにすでに入っているので、PATHに1行追加すればすぐ使えます:

sudo mkdir -p /usr/local/bin
sudo ln -sf /Applications/Kura.app/Contents/MacOS/kura-cli /usr/local/bin/kura
kura status

ソースから実行する場合:

cargo run --manifest-path ./kura-mcp/Cargo.toml --bin kura -- status
cargo run --manifest-path ./kura-mcp/Cargo.toml --bin kura -- balance
cargo run --manifest-path ./kura-mcp/Cargo.toml --bin kura -- history --limit 10
cargo run --manifest-path ./kura-mcp/Cargo.toml --bin kura -- pay <주소> <금액> --token usdc
cargo run --manifest-path ./kura-mcp/Cargo.toml --bin kura -- fetch <URL>

pay/fetchはパスワードをCLIで受け取りません — Kuraアプリが起動している必要があり、承認ポップアップで人間がパスワードを入力します。

テスト:

(cd src-tauri && cargo test)        # 백엔드(지갑·암호화·한도·송금)
(cd kura-mcp && cargo test)         # MCP/CLI 어댑터
npx tsc --noEmit && npx vite build  # 프론트

配布物（署名・公証済みDMG）を作成する手順は**docs/RELEASE.md**にあります。Apple Developerアカウントと1回の設定が必要で、その後は1行です:

./scripts/release.sh

技術スタック

構造: [Rustコア(src-tauri)] ← MCP / CLIアダプター(kura-mcp)。鍵へのアクセス（署名）はGUIプロセスのみ — それが最終防衛線です。

ライセンス・ステータス

MITライセンス — 鍵とお金を扱うコードなので、直接読んで検証し、修正できるべきだと考えています。

脆弱性を発見した場合は、イシューとして上げる前に**SECURITY.mdの非公開パスでお知らせください。同じ文書にKuraが防げないこと**も書いてあります。

同梱のPretendardフォントはSIL Open Font License 1.1です（全文）。

最優先ユーザーは自分自身 — Apple Silicon MacでローカルLLM/Claudeで決済する韓国の開発者・クリエイターのためのウォレットです。まだ0.1.x初期バージョンなので、デフォルトのテストネットで先に慣れてから、メインネットには失ってもいい分だけ入れることをお勧めします。