インストール
コンテンツ詳細
代替品
インストール
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["@aibtc/mcp-server@latest"],
"env": {
"NETWORK": "mainnet"
}
}
}
}
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["-y", "@aibtc/mcp-server@latest"],
"env": {
"NETWORK": "mainnet"
}
}
}
}
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["@aibtc/mcp-server@latest"],
"env": {
"CLIENT_MNEMONIC": "your twenty four word mnemonic phrase",
"NETWORK": "testnet"
}
}
}
}🚀 @aibtc/mcp-server
BitcoinネイティブのMCPサーバーで、AIエージェント向けにBTC/STXウォレット、DeFi収益、sBTCペグ、NFT、x402支払いを提供します。
🚀 クイックスタート
Claude Code (ターミナル)
npx @aibtc/mcp-server@latest --install
以上で完了です!これで自動的にClaude Codeが設定されます。ターミナルを再起動してチャットを開始しましょう。
Claude Desktop (アプリ)
npx @aibtc/mcp-server@latest --install --desktop
このコマンドはOSを検出し、正しいClaude Desktopの設定ファイルに書き込みます。
| OS | 設定ファイルのパス |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
| Windows | %APPDATA%/Claude/claude_desktop_config.json |
インストール後、Claude Desktopを再起動してください。
テストネットモード
いずれかのコマンドに --testnet を追加します。
# テストネットでClaude Codeを使用する場合
npx @aibtc/mcp-server@latest --install --testnet
# テストネットでClaude Desktopを使用する場合
npx @aibtc/mcp-server@latest --install --desktop --testnet
⚠️ 重要提示
なぜ
npxを使うのか?npx @aibtc/mcp-server@latestを使用すると、常に最新バージョンが自動的に取得されます。グローバルインストール (npm install -g) では自動更新されません。
手動設定
手動で設定する場合は、設定ファイルに以下を追加します。
Claude Code (~/.claude.json):
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["@aibtc/mcp-server@latest"],
"env": {
"NETWORK": "mainnet"
}
}
}
}
Claude Desktop (claude_desktop_config.json - 上記のパス表を参照):
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["-y", "@aibtc/mcp-server@latest"],
"env": {
"NETWORK": "mainnet"
}
}
}
}
⚠️ 重要提示
Claude Desktopでは、
npxが確認を求めないように、引数に-yフラグが必要です。
✨ 主な機能
- Bitcoin L1 - 残高の確認、BTCの送信、mempool.spaceを通じたUTXOの管理ができます。
- エージェント独自のウォレット - エージェントは独自のウォレットを持ち、ブロックチェーントランザクションを実行できます。
- 安全なストレージ - ウォレットはAES-256-GCMで暗号化され、ローカルに保存されます。
- 150以上のツール - Bitcoin L1と包括的なStacks L2の操作をサポートします。
- sBTCサポート - Stacks上のネイティブBitcoinの操作が可能です。
- トークン操作 - SIP-010ファンジブルトークンの転送と照会ができます。
- NFTサポート - SIP-009 NFTの保有、転送、メタデータの取得ができます。
- DeFi取引 - ALEX DEXのスワップとZest Protocolの貸し借りが可能です。
- Stacking/PoX - Stackingの状況と委任が確認できます。
- BNSドメイン - .btcドメインの検索と管理 (V1 + V2) ができます。
- x402支払い - 有料APIの自動支払い処理をサポートします。
💻 使用例
基本的な使用法
あなた: あなたのウォレットアドレスは何ですか?
Claude: まだウォレットを持っていません。ウォレットを割り当てますか?
新しいウォレットを作成するか、既存のウォレットをインポートすることができます。
あなた: 「agent-wallet」という名前の新しいウォレットを作成してください
Claude: ウォレットを保護するためにどのパスワードを使用しますか?
あなた: 「secure123password」を使用してください
Claude: ウォレットを作成しました!私のアドレスはST1ABC...XYZです。
重要: この復旧フレーズを安全に保存してください。
"word1 word2 word3 ... word24"
このフレーズは再度表示されません。パスワードを忘れた場合にウォレットを回復する唯一の方法です。
あなた: ST2DEF...に10 STXを送ってください
Claude: 完了しました!10 STXをST2DEF...に送りました。
トランザクション: 0x123...
高度な使用法
あなた: 「my-wallet」という名前のウォレットを作成してください
Claude: ウォレットを作成しました。
Stacksアドレス: ST1ABC...
Bitcoinアドレス: bc1q...
あなた: bc1q...に50000サットシを送ってください
Claude: 完了しました!トランザクションがブロードキャストされました: abc123...
📚 ドキュメント
ウォレットの管理
| ツール | 説明 |
|---|---|
wallet_create |
Claude用の新しいウォレットを作成します。 |
wallet_import |
Claude用に既存のウォレットをインポートします。 |
wallet_unlock |
Claudeのウォレットをロック解除します。 |
wallet_lock |
Claudeのウォレットをロックします。 |
wallet_list |
Claudeの利用可能なウォレットをリストします。 |
wallet_switch |
Claudeを別のウォレットに切り替えます。 |
wallet_delete |
ウォレットを削除します。 |
wallet_export |
ウォレットのニーモニックをエクスポートします。 |
wallet_status |
Claudeのウォレットが使用可能かどうかを確認します (StacksとBitcoinのアドレスを含む)。 |
wallet_set_timeout |
ウォレットのロック解除時間を設定します。 |
Bitcoin L1
| ツール | 説明 |
|---|---|
get_btc_balance |
BTCの残高 (合計、確認済み、未確認) を取得します。 |
get_btc_fees |
手数料の見積もり (高速、中速、低速) を取得します。 |
get_btc_utxos |
アドレスのUTXOをリストします。 |
transfer_btc |
BTCを受取人に送ります。 |
get_cardinal_utxos |
安全に使用できるUTXO (インスクリプションなし) を取得します。 |
get_ordinal_utxos |
インスクリプションを含むUTXOを取得します。 |
Bitcoinインスクリプション
| ツール | 説明 |
|---|---|
get_taproot_address |
ウォレットのTaproot (P2TR) アドレスを取得します。 |
estimate_inscription_fee |
インスクリプションのコストを計算します。 |
inscribe |
インスクリプションコミットトランザクションを作成します。 |
inscribe_reveal |
インスクリプションの開示トランザクションを完了します。 |
get_inscription |
開示トランザクションからインスクリプションの内容を取得します。 |
get_inscriptions_by_address |
アドレスが所有するインスクリプションをリストします。 |
PSBTとオーディナル取引
| ツール | 説明 |
|---|---|
psbt_create_ordinal_buy |
オーディナル購入の買い手側のPSBTを作成します。 |
psbt_sign |
選択したPSBT入力をアクティブなウォレットキーで署名します。 |
psbt_decode |
PSBTの入力/出力/署名状態をデコードします。 |
psbt_broadcast |
完全に署名されたPSBTを最終化してブロードキャストします。 |
メッセージ署名
| ツール | 説明 |
|---|---|
sip018_sign |
構造化されたClarityデータ (SIP-018) を署名します。 |
sip018_verify |
SIP-018の署名を検証します。 |
sip018_hash |
署名せずにSIP-018のハッシュを計算します。 |
stacks_sign_message |
平文を署名します (SIWS互換)。 |
stacks_verify_message |
Stacksメッセージの署名を検証します。 |
btc_sign_message |
Bitcoinキーで署名します (BIP-137)。 |
btc_verify_message |
BIP-137の署名を検証します。 |
ウォレットと残高
| ツール | 説明 |
|---|---|
get_wallet_info |
Claudeのウォレットアドレス (Stacks + Bitcoin) と状態を取得します。 |
get_stx_balance |
任意のアドレスのSTX残高を取得します。 |
get_stx_fees |
STXの手数料見積もり (低、中、高) を取得します。 |
STX転送
| ツール | 説明 |
|---|---|
transfer_stx |
STXを受取人に送ります。 |
broadcast_transaction |
事前に署名されたトランザクションをブロードキャストします。 |
sBTC操作
| ツール | 説明 |
|---|---|
sbtc_get_balance |
sBTCの残高を取得します。 |
sbtc_transfer |
sBTCを送ります。 |
sbtc_initiate_withdrawal |
sBTCのBTC L1へのペグアウトを開始します。 |
sbtc_withdraw |
引き出し開始のエイリアスです。 |
sbtc_withdrawal_status |
引き出し要求の状態を確認します。 |
sbtc_get_deposit_info |
BTCの入金指示を取得します。 |
sbtc_deposit |
BTC→sBTCの入金を構築、署名、ブロードキャストします。 |
sbtc_deposit_status |
Emily APIを通じて入金状態を確認します。 |
sbtc_get_peg_info |
ペグ比率とTVLを取得します。 |
トークン操作 (SIP-010)
| ツール | 説明 |
|---|---|
get_token_balance |
任意のSIP-010トークンの残高を取得します。 |
transfer_token |
任意のSIP-010トークンを送ります。 |
get_token_info |
トークンのメタデータを取得します。 |
list_user_tokens |
アドレスが所有するトークンをリストします。 |
get_token_holders |
トークンの上位保有者を取得します。 |
NFT操作 (SIP-009)
| ツール | 説明 |
|---|---|
get_nft_holdings |
アドレスが所有するNFTをリストします。 |
get_nft_metadata |
NFTのメタデータを取得します。 |
transfer_nft |
NFTを送ります。 |
get_nft_owner |
NFTの所有者を取得します。 |
get_collection_info |
NFTコレクションの詳細を取得します。 |
get_nft_history |
NFTの転送履歴を取得します。 |
Stacking / PoX
| ツール | 説明 |
|---|---|
get_pox_info |
現在のPoXサイクル情報を取得します。 |
get_stacking_status |
Stackingの状態を確認します。 |
stack_stx |
STXをロックしてStackingします。 |
extend_stacking |
Stacking期間を延長します。 |
BNSドメイン (V1 + V2)
| ツール | 説明 |
|---|---|
lookup_bns_name |
.btcドメインをアドレスに解決します。 |
reverse_bns_lookup |
アドレスの.btcドメインを取得します。 |
get_bns_info |
ドメインの詳細を取得します。 |
check_bns_availability |
ドメインが利用可能かどうかを確認します。 |
get_bns_price |
登録価格を取得します。 |
list_user_domains |
所有するドメインをリストします。 |
preorder_bns_name |
.btcドメインを事前予約します (2ステップのうちの1ステップ)。 |
register_bns_name |
.btcドメインを登録します (2ステップのうちの2ステップ)。 |
スマートコントラクト
| ツール | 説明 |
|---|---|
call_contract |
スマートコントラクトの関数を呼び出します。 |
deploy_contract |
Clarityスマートコントラクトをデプロイします。 |
get_transaction_status |
トランザクションの状態を確認します。 |
call_read_only_function |
読み取り専用関数を呼び出します。 |
DeFi - ALEX DEX (メインネット)
公式の alex-sdk を使用してスワップ操作を行います。「STX」、「ALEX」などの単純なトークンシンボルをサポートします。
| ツール | 説明 |
|---|---|
alex_list_pools |
利用可能なすべての取引プールを探します。 |
alex_get_swap_quote |
トークンスワップの予想出力を取得します。 |
alex_swap |
トークンスワップを実行します (SDKがルーティングを処理します)。 |
alex_get_pool_info |
流動性プールのリザーブを取得します。 |
DeFi - Zest Protocol (メインネット)
10の資産をサポートします: sBTC、aeUSDC、stSTX、wSTX、USDH、sUSDT、USDA、DIKO、ALEX、stSTX-BTC。
| ツール | 説明 |
|---|---|
zest_list_assets |
サポートされているすべての貸出資産をリストします。 |
zest_get_position |
ユーザーの供給/借入ポジションを取得します。 |
zest_supply |
資産を供給して利息を獲得します。 |
zest_withdraw |
供給した資産を引き出します。 |
zest_borrow |
担保に対して借入します。 |
zest_repay |
借入した資産を返済します。 |
DeFi - Bitflow DEX (メインネット)
複数の流動性ソースを横断して取引をルーティングするDEXアグリゲーターです。
⚠️ 重要提示
単位: Bitflowのツールはデフォルトで 人間単位 (
amountUnit: "human") を使用します。2 STXを交換するには"2"を渡し、"2000000"ではないことに注意してください。生のオンチェーン整数で作業する場合のみ、amountUnit: "base"を設定してください。詳細と一般的な落とし穴については、単位と小数のガイド を参照してください。
| ツール | 説明 |
|---|---|
bitflow_get_ticker |
市場データを取得します (APIキー不要)。 |
bitflow_get_quote |
スワップの見積もりを取得します。 |
bitflow_swap |
トークンスワップを実行します。 |
Pillarスマートウォレット
Zest Protocolと統合され、パスキー認証を備えたsBTCスマートウォレットです。
| ツール | 説明 |
|---|---|
pillar_connect |
Pillarウォレットに接続します。 |
pillar_send |
sBTCをBNS名またはアドレスに送ります。 |
pillar_boost |
レバレッジ付きのsBTCポジションを作成します。 |
pillar_position |
ウォレットとZestのポジションを表示します。 |
自律型エージェントの場合は、pillar_direct_* ツールを使用します (ブラウザ不要)。
ブロックチェーンクエリ
| ツール | 説明 |
|---|---|
get_account_info |
アカウントのノンス、残高を取得します。 |
get_account_transactions |
トランザクション履歴をリストします。 |
get_block_info |
ブロックの詳細を取得します。 |
get_mempool_info |
未処理のトランザクションを取得します。 |
get_contract_info |
コントラクトのABIとソースを取得します。 |
get_contract_events |
コントラクトのイベント履歴を取得します。 |
get_network_status |
ネットワークの健全性を取得します。 |
Yield Hunter (自律型)
| ツール | 説明 |
|---|---|
yield_hunter_start |
自律的なsBTC→Zestの入金を開始します。 |
yield_hunter_stop |
収益獲得を停止します。 |
yield_hunter_status |
収益獲得の状態を確認します。 |
yield_hunter_configure |
閾値、予備金、間隔を調整します。 |
x402 APIエンドポイント
| ツール | 説明 |
|---|---|
list_x402_endpoints |
x402エンドポイントを探します。 |
execute_x402_endpoint |
自動支払いでx402エンドポイントを実行します。 |
scaffold_x402_endpoint |
x402 Cloudflare Workerプロジェクトを生成します。 |
scaffold_x402_ai_endpoint |
OpenRouterを使用したx402 AI APIを生成します。 |
サポートされるトークン
よく知られたトークンはシンボルで参照できます。
- sBTC - Stacks上のネイティブBitcoin
- USDCx - Stacks上のUSD Coin
- ALEX - ALEXガバナンストークン
- wSTX - Wrapped STX
ALEX DEXトークン: STX、ALEX、および alex_list_pools からの任意のトークン
Zest Protocol資産: sBTC、aeUSDC、stSTX、wSTX、USDH、sUSDT、USDA、DIKO、ALEX、stSTX-BTC
または、コントラクトIDで任意のSIP-010トークンを使用できます: SP2X...::token-name
設定
| 環境変数 | 説明 | デフォルト |
|---|---|---|
NETWORK |
mainnet または testnet |
mainnet (インストーラー) / testnet (未設定の場合) |
API_URL |
デフォルトのx402 APIベースURL | https://x402.biwas.xyz |
CLIENT_MNEMONIC |
(オプション) 事前に設定されたニーモニック | - |
HIRO_API_KEY |
(オプション) より高いレート制限のためのHiro APIキー | - |
⚠️ 重要提示
NETWORKに関する注意:--installコマンドはデフォルトでNETWORK=mainnetを書き込みます (テストネットを使用するには--testnetを渡してください)。設定からNETWORKを完全に省略した場合、ランタイムのフォールバックはtestnetです。ほとんどのユーザーはこれを明示的に設定する必要があります。
⚠️ 重要提示
CLIENT_MNEMONICはオプションです。推奨される方法は、Claudeに独自のウォレットを作成させることです。HIRO_API_KEYはオプションですが、本番環境での使用には推奨されます — これを使用しない場合、Hiroの公開レート制限 (429応答) に達する可能性があります。キーは platform.hiro.so で取得できます。
アーキテクチャ
あなた ←→ Claude ←→ aibtc-mcp-server
↓
Claudeのウォレット (~/.aibtc/)
↓
┌─────────┴─────────┐
↓ ↓
Hiro Stacks API x402エンドポイント
↓ ↓
Stacksブロックチェーン 有料APIサービス
セキュリティに関する注意事項
- Claudeのウォレットはあなたのマシンに暗号化されて保存されています。
- パスワードは保存されず、暗号化されたキーストアのみが保存されます。
- ニーモニックは作成時に一度だけ表示されます。
- 15分後に自動ロックされます (設定可能)。
- トランザクションはブロードキャスト前にローカルで署名されます。
- メインネットの場合は、まず少量の資金を入れてください。
上級者向け: 事前設定されたニーモニック
Claudeがすぐにウォレットにアクセスする必要がある自動化されたセットアップの場合は、MCPサーバーの設定に CLIENT_MNEMONIC 環境変数を追加します (Claude Codeの場合は ~/.claude.json、Claude Desktopの場合は claude_desktop_config.json)。
{
"mcpServers": {
"aibtc": {
"command": "npx",
"args": ["@aibtc/mcp-server@latest"],
"env": {
"CLIENT_MNEMONIC": "あなたの24語のニーモニックフレーズ",
"NETWORK": "testnet"
}
}
}
}
これにより、ウォレット作成のフローをスキップし、Claudeはすぐにトランザクションを実行できます。
エージェントスキル
このパッケージには、Agent Skills 互換のスキルが含まれており、任意のLLMにBitcoinウォレットの機能を効果的に使用する方法を教えます。
これは何ですか?
aibtc-bitcoin-wallet スキルは以下を提供します。
- Bitcoin L1操作 (残高、送信、手数料) の構造化されたワークフロー
- PillarスマートウォレットとStacks L2 DeFiのリファレンスガイド
- Claude Code、Cursor、Codexなど20以上のツールで動作するLLM非依存の指示
スキルの使用方法
MCPサーバーをインストールすると、スキルは自動的に含まれます。以下の場所で見つけることができます。
- ローカル:
node_modules/@aibtc/mcp-server/skill/SKILL.md - ClawHub: clawhub.ai/skills -
aibtc-bitcoin-walletを検索してください。
スキルの構造
skill/
├── SKILL.md # Bitcoin L1のコアワークフロー
└── references/
├── genesis-lifecycle.md # エージェントの登録とチェックイン
├── inscription-workflow.md # Bitcoinインスクリプションガイド
├── pillar-wallet.md # Pillarスマートウォレットガイド
├── stacks-defi.md # Stacks L2 / DeFi操作
└── troubleshooting.md # 一般的な問題と解決策
開発
git clone https://github.com/aibtcdev/aibtc-mcp-server.git
cd aibtc-mcp-server
npm install
npm run build
npm run dev # tsxで実行 (開発用)
リリース
このリポジトリは、自動化されたリリースのために Release Please を使用しています。
- コンベンショナルコミット (
feat:、fix:など) でPRをマージします。 - Release Pleaseが変更履歴付きのRelease PRを作成します。
- Release PRをマージして公開します。
リポジトリのシークレット (メンテナー用)
| シークレット | 説明 |
|---|---|
NPM_TOKEN |
@aibtcスコープのnpm公開トークン |
CLAWHUB_API_TOKEN |
スキルを公開するためのClawHub APIトークン |
ClawHub APIトークンを取得するには、clawhub.ai にアクセスしてアカウントを作成してください。
📄 ライセンス
MIT
代替品











