Sediakan MCP

Pasang dan konfigurasikan pelayan MCP IronWallet untuk Cursor, Claude Code, ChatGPT, dan klien MCP lain.

Pelayan MCP IronWallet (@ironwallet/mcp-server) memberikan ejen AI dompet kripto bukan jagaan (non-custodial) pada komputer anda. Frasa benih dijana dan disulitkan secara setempat — ia tidak pernah meninggalkan mesin ini dan tidak pernah melalui ejen, LLM, atau bahagian belakang IronWallet. Ejen boleh menyemak baki, menunjukkan kod QR deposit, memindahkan token, dan menukar merentasi 12 rangkaian: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP, dan TON.

Tiada UI pengesahan setiap transaksi — sebaik sahaja anda meminta ejen untuk menghantar atau menukar, ia boleh menandatangani dan menyiarkan tanpa bertanya lagi. Gunakan dompet panas (hot wallet) khusus dengan baki terhad, jangan sekali-kali gunakan dompet utama anda.

Keperluan: Node.js 20+ (npx). Desktop / stdio sahaja.

Ciri-ciri

Bukan jagaan, penandatanganan setempat

Frasa benih kekal disulitkan pada hos (kebenaran fail pemilik sahaja). Transaksi ditandatangani pada mesin ini; tiada alat yang menerima atau mengembalikan benih.

Dompet dalam pelayar setempat

Buat dompet dengan create_wallets (mengembalikan backup_url), atau import dan sandarkan melalui open_wallet_manager — halaman gelung balik sahaja pada 127.0.0.1 yang ditutup selepas 15 minit tidak aktif. Rahsia hanya muncul dalam halaman pelayar itu, tidak pernah dalam sembang.

Pemindahan dengan anggaran yuran

estimate_transfer mempratonton yuran tanpa menyiarkan; send_transfer menandatangani secara setempat dan menghantar; get_operation_status meninjau keputusan. Pelayan mungkin mengurangkan jumlah sedikit supaya yuran masih muat dengan baki — respons menyatakan apabila itu berlaku.

Pertukaran dipacu katalog

list_swap_networks dan list_swap_assets menyediakan katalog jual/beli supaya ejen tidak pernah mencipta alamat token. estimate_swap memberikan sebut harga, execute_swap melaksanakan pada sebut harga baharu, get_swap_status meninjau.

Kod QR deposit

get_deposit_qr mengembalikan PNG untuk sembang berserta sandaran qr_url setempat.

Had perbelanjaan pilihan

Dasar setiap dompet melalui set_wallet_policy: readOnly, maxPerTxUsd, dan senarai benarkan penerima pemindahan. Dimatikan secara lalai; terpakai untuk kedua-dua penghantaran dan pertukaran. IW_READ_ONLY=true menjadikan keseluruhan pelayan sebagai baca sahaja.

Pemasangan

Pilihan 1: npx (disyorkan)

Gunakan npx untuk menjalankan pelayan tanpa pemasangan global. Ini memastikan anda sentiasa menggunakan versi terkini.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Pelancaran pertama mungkin mengambil masa ~30 saat semasa dependensi dipasang. Jika klien MCP anda tamat masa, jalankan arahan sekali dalam terminal untuk memanaskan cache, kemudian sambung semula.

Pilihan 2: Pemasangan global

Pasang pakej secara global untuk permulaan yang lebih pantas, kemudian jalankan ironwallet-mcp.

npm install -g @ironwallet/mcp-server@latest

Panduan persediaan

Hanya untuk desktop

Setiap klien mempunyai URL statik khusus (contohnya /ai/introduction/vscode/). Semua arahan pasang di bawah juga disertakan dalam halaman ini — tiada tab, tiada apa yang tersembunyi di sebalik klik.

Cursor

Paling disyorkan

Paling disyorkan

Berfungsi dengan baik dengan versi percuma, pemasangan mudah, pengalaman terbaik

Buka dalam Cursor

Pasang sekali. Selepas itu, alatan dompet tersedia dalam setiap sembang. Anda juga boleh menampal ini ke dalam ~/.cursor/mcp.json dan mulakan semula Cursor.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Muat semula Cursor selepas pasang supaya PATH menyertakan npx.

Halaman kendiri untuk Cursor — satu pengambilan HTTP hanya mengembalikan panduan ini.

Claude Code

Memerlukan tahap pakar yang lebih tinggi

Berfungsi dengan baik dengan mod Kod, mod Sembang sangat terhad

Buka dalam Claude Code

Jalankan arahan ini mengikut urutan:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit
2claude plugin install ironwallet-mcp@ironwallet

Selepas pasang pemalam, tunggu ~45 saat dan mulakan sembang baharu supaya alatan dimuatkan.

Atau halakan Claude Code pada pelayan stdio secara terus:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Halaman kendiri untuk Claude Code — satu pengambilan HTTP hanya mengembalikan panduan ini.

VS Code

Tahap pakar tertinggi

Memerlukan pemalam tambahan dengan versi berbayar model AI

Buka dalam VS Code

Membuka VS Code dan mendaftarkan pelayan MCP setempat. Anda juga boleh menambah ini pada tetapan MCP VS Code anda (pengguna atau ruang kerja).

1{
2 "mcp": {
3 "servers": {
4 "ironwallet": {
5 "type": "stdio",
6 "command": "npx",
7 "args": ["-y", "@ironwallet/mcp-server"]
8 }
9 }
10 }
11}

Halaman kendiri untuk VS Code — satu pengambilan HTTP hanya mengembalikan panduan ini.

ChatGPT

Persediaan mudah - memerlukan ChatGPT

Versi percuma sangat terhad, versi berbayar berfungsi lebih baik

Buka dalam ChatGPT

Jalankan arahan ini mengikut urutan, kemudian muat semula supaya alatan MCP tersedia.

1codex plugin marketplace add ironwallet/ironwallet-agent-kit
2codex plugin add ironwallet-mcp@ironwallet

Atau halakan ChatGPT pada pelayan stdio secara terus:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Halaman kendiri untuk ChatGPT — satu pengambilan HTTP hanya mengembalikan panduan ini.

Klien lain

Gunakan pengangkutan stdio. Halakan klien MCP anda kepada:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Halaman kendiri untuk Klien lain — satu pengambilan HTTP hanya mengembalikan panduan ini.

Larian pertama & persediaan dompet

Tiada daftar masuk dan tiada akaun. Pada pelancaran pertama, pelayan menjana rahsia setempatnya — kunci API geganti, rahsia pembalut kedai kunci, dan id peranti — di bawah ~/.ironwallet-mcp/ dengan kebenaran pemilik sahaja. Tiada apa yang perlu dikonfigurasikan.

Untuk mula menggunakan dompet:

1
Persetujuan. Sebelum membuat atau mengimport dompet, ejen menunjukkan penafian MCP dalam sembang dan merekodkan penerimaan anda (accept_mcp_consent), atau anda menekan Teruskan dalam pengurus dompet.
2
Buat atau import. create_wallets mengembalikan nama dan alamat dompet berserta backup_url — bukanya dalam pelayar anda untuk melihat dan menyandarkan frasa pemulihan. Untuk mengimport dompet sedia ada atau membuat sandaran kemudian, gunakan open_wallet_manager. Frasa pemulihan ditaip atau ditunjukkan hanya dalam halaman pelayar setempat, tidak pernah dalam sembang.
3
Danai dompet. Minta ejen untuk kod QR deposit (get_deposit_qr) atau alamat (list_wallets) dan hantar jumlah kecil. Pastikan baki terhad — ini ialah dompet panas.

Data pada cakera

Pelayan menyimpan statusnya dalam ~/.ironwallet-mcp/ (ganti dengan IW_KEYSTORE_DIR):

kedai kunci yang disulitkan dengan benih dompet anda,

rahsia pembalut, kunci API geganti, dan id peranti,

log diagnostik di bawah logs/ (bahan benih tidak pernah direkodkan).

Amaran: jangan padam direktori ini untuk "menetapkan semula" pelayan.

Ia mengandungi kunci yang disulitkan untuk dana anda. Jika anda mengalih keluarnya tanpa membuat sandaran frasa pemulihan dalam pengurus dompet, dana akan hilang. Sandaran anda ialah frasa pemulihan, bukan fail-fail ini.

Sesiapa yang mempunyai kedai kunci dan rahsia pembalut mengawal dana tersebut, jadi anggap direktori itu sebagai sensitif.

Pemboleh ubah persekitaran

Kebanyakan pengguna tidak perlu menetapkan sebarang pemboleh ubah persekitaran. Pelayan menjana dan menyimpan semua yang diperlukan pada pelancaran pertama. Berikut tersedia untuk kegunaan lanjutan:

Pemboleh ubah
Penerangan
Lalai
IW_READ_ONLY
Tolak send_transfer dan execute_swap di seluruh proses. Berbeza daripada policy.readOnly setiap dompet
false
IW_KEYSTORE_DIR
Direktori kedai kunci
~/.ironwallet-mcp
IW_PASSPHRASE
Ganti rahsia pembalut kedai kunci
generated locally
IW_RELAY_API_KEY
Ganti kunci API geganti
generated UUID
IW_HTTP_TIMEOUT_MS
Tamat masa HTTP umum
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Tamat masa untuk panggilan gaya siaran. Tamat masa klien tidak selalunya bermakna operasi gagal — semak status
60000
IW_LOG_ENABLED
Diagnostik JSONL ke fail log (0 untuk melumpuhkan)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Keselamatan

Benih tidak pernah meninggalkan mesin ini. Ia disulitkan semasa rehat dan tidak pernah muncul dalam keputusan alat, sembang ejen, log, atau permintaan bahagian belakang. Tiada alat yang menerima atau mengembalikan benih — import dan sandaran hanya berlaku dalam pelayar setempat.

Ejen boleh memindahkan dana tanpa bertanya lagi. Tiada UI pengesahan setiap transaksi; mesej sembang anda ialah kebenaran. Pemindahan dan pertukaran tidak boleh diterbalikkan sebaik sahaja disiarkan.

Had pilihan. Dasar setiap dompet (readOnly, maxPerTxUsd, senarai benarkan penerima) melalui set_wallet_policy, dan IW_READ_ONLY=true seluruh pelayan. Kedua-duanya dimatikan secara lalai.

Dompet panas sahaja. Jangan import dompet utama atau simpanan anda. Sesiapa yang mempunyai kedai kunci dan rahsia pembalut mengawal dana tersebut; benih yang bocor tidak boleh dibatalkan.

Tamat masa bukan kegagalan. Tinja get_operation_status / get_swap_status sebelum mencuba semula penghantaran atau pertukaran.

Semua permintaan bahagian belakang menggunakan HTTPS; fail rahsia setempat menggunakan kebenaran pemilik sahaja (Unix 0600, NTFS ACL pada Windows).

Pendedahan kerentanan: SECURITY.md.

Ujian

Uji pelayan secara terus menggunakan pemeriksa MCP. Ini membuka UI web interaktif di mana anda boleh menguji panggilan alat tanpa pembantu AI.

npx @modelcontextprotocol/inspector npx -y @ironwallet/mcp-server

Penyelesaian masalah

Klien MCP tamat masa pada permulaan pertama

npx memuat turun pakej pada larian pertama, yang boleh mengambil masa ~30 saat.

  • Jalankan npx -y @ironwallet/mcp-server sekali dalam terminal untuk memanaskan cache, kemudian sambung semula.
  • Atau pasang secara global: npm install -g @ironwallet/mcp-server@latest.

Alatan tidak muncul dalam klien

  • Semak Node.js 20+ dipasang: node --version.
  • Muat semula klien selepas pasang supaya PATH menyertakan npx.
  • Selepas pasang pemalam (Claude Code / ChatGPT), mulakan sembang baharu supaya alatan dimuatkan.
  • Sahkan fail konfigurasi mengandungi JSON yang sah dan mulakan semula klien.
  • Uji pelayan secara manual dengan pemeriksa MCP (lihat Ujian).

create_wallets mengembalikan needs_consent

Penafian MCP belum diterima lagi. Minta ejen untuk menunjukkan penafian penuh dan sahkan (accept_mcp_consent), atau buka pengurus dompet dan tekan Teruskan.

Pemindahan atau pertukaran tamat masa

Tamat masa bukan kegagalan — transaksi mungkin telah disiarkan. Tinja get_operation_status (pemindahan) atau get_swap_status (pertukaran) sebelum mencuba semula. Jangan sekali-kali hantar semula secara membuta tuli.

Penghantaran atau pertukaran ditolak

  • Semak list_wallets → policy: readOnly atau senarai benarkan penerima mungkin menyekat operasi. { enabled: false } bermakna tiada had.
  • maxPerTxUsd gagal ditutup: jika tiada kadar USD tersedia untuk aset tersebut, operasi ditolak.
  • Semak sama ada pelayan berjalan dengan IW_READ_ONLY=true.