インストール
コンテンツ詳細
代替品
インストール
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
"env": {
"PRIVATE_KEY": "your_private_key_here (optional)"
}
}
}
}
{
"mcpServers": {
"binance": {
"command": "npx",
"args": ["ts-node", "binance-mcp-server/src/index.ts"],
"env": {
"BINANCE_API_KEY": "your_key",
"BINANCE_API_SECRET": "your_secret"
}
}
}
}
{
"mcpServers": {
"binance-us": {
"command": "node",
"args": ["binance-us-mcp-server/build/index.js"],
"env": {
"BINANCE_US_API_KEY": "your_key",
"BINANCE_US_API_SECRET": "your_secret"
}
}
}
}
{
"mcpServers": {
"universal-crypto-mcp": {
"type": "http",
"url": "https://modelcontextprotocol.name/mcp/universal-crypto-mcp"
}
}
}🚀 ユニバーサルクリプトMCP
ユニバーサルクリプトMCPは、すべてのEVM互換ネットワークとソルナに対応したユニバーサルモデルコンテキストプロトコルサーバーです。AIエージェント(Claude、ChatGPT、Cursorなど)が自然言語で任意のEVMブロックチェーンと対話できるようにします。
██╗ ██╗███╗ ██╗██╗██╗ ██╗███████╗██████╗ ███████╗ █████╗ ██╗
██║ ██║████╗ ██║██║██║ ██║██╔════╝██╔══██╗██╔════╝██╔══██╗██║
██║ ██║██╔██╗ ██║██║██║ ██║█████╗ ██████╔╝███████╗███████║██║
██║ ██║██║╚██╗██║██║╚██╗ ██╔╝██╔══╝ ██╔══██╗╚════██║██╔══██║██║
╚██████╔╝██║ ╚████║██║ ╚████╔╝ ███████╗██║ ██║███████║██║ ██║███████╗
╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚══════╝
██████╗██████╗ ██╗ ██╗██████╗ ████████╗ ██████╗
██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝██╔═══██╗
██║ ██████╔╝ ╚████╔╝ ██████╔╝ ██║ ██║ ██║
██║ ██╔══██╗ ╚██╔╝ ██╔═══╝ ██║ ██║ ██║
╚██████╗██║ ██║ ██║ ██║ ██║ ╚██████╔╝
╚═════╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝
███╗ ███╗ ██████╗██████╗
████╗ ████║██╔════╝██╔══██╗
██╔████╔██║██║ ██████╔╝
██║╚██╔╝██║██║ ██╔═══╝
██║ ╚═╝ ██║╚██████╗██║
╚═╝ ╚═╝ ╚═════╝╚═╝
npx @nirholas/universal-crypto-mcp
✨ 新機能: AIサービスマーケットプレイス
AIサービスを収益化し、最高のAPIを発見しましょう! 💸
AIサービスマーケットプレイス は、AIサービスの発見、収益化、および評判管理のための包括的なエコシステムです。
- 🏪 AIサービスを登録 - ペイパーユースまたはサブスクリプションによる即時収益化
- 🔍 AIエージェントがサービスを発見 - カテゴリ、価格、評価による自動発見
- ⭐ オンチェーン評判 - 検証済みの評価とレビューによる信頼構築
- 💳 柔軟な価格設定 - ペイパーユース、サブスクリプション、無料枠
- 📊 分析ダッシュボード - 使用状況、収益、およびパフォーマンスの追跡
- 🔒 安全な支払い - エスクロー、紛争解決、自動返金
詳細を学ぶ → | チュートリアルを表示 →
x402支払いプロトコル
AIエージェントがインターネット上で支払いを行えるようになりました! 💸
ユーザー: "東京のプレミアム天気データを取得して"
Claude: 🔍 x402残高を確認中... $45.23 USD
💳 プレミアムAPIアクセスに $0.01 を支払っています...
✅ 支払いが確認されました!こちらが詳細な予報です:
🌤️ 東京の天気 (7日間のプレミアム予報)...
AIエージェントは現在、以下のことができます:
- 💸 自動的にプレミアムAPIに支払う
- 🏪 他のエージェントに自らのサービスを販売する
- 🔄 他のAIエージェントとピアツーピアで取引する
- ⛓️ EVM + ソルナチェーンをまたがって動作する
⭐ このプロジェクトが役に立った場合は、リポジトリをスターしてください! これにより、他の人がこのプロジェクトを見つけやすくなります。
🆚 なぜユニバーサルクリプトMCPなのか?
| 機能 | ユニバーサルクリプトMCP | 他のMCPサーバー |
|---|---|---|
| ツール | 380以上のツール | 10 - 50のツール |
| チェーン | 20以上のチェーン (EVM + マルチチェーン) | 1 - 3のチェーン |
| DEXサポート | マルチアグリゲーター (1inch、0x、ParaSwap) | 単一のDEXまたはなし |
| セキュリティ | GoPlus、ホニーポット、ラグプル検出 | 基本的なものまたはなし |
| DeFi | Aave、Compound、Lido、Uniswap | 限定的 |
| 市場データ | CoinGecko、DefiLlama、LunarCrush | 基本的な価格 |
| ブリッジ | LayerZero、Stargate、Wormhole | なし |
| MEV保護 | Flashbots統合 | なし |
| トランスポート | stdio、HTTP、SSE | 通常はstdioのみ |
| ChatGPTサポート | ✅ ネイティブHTTPモード | ❌ ほとんど対応していない |
📦 パッケージ構造
最も包括的なクリプトMCPモノレポで、最高のMITライセンスのプロジェクトから 10以上の統合パッケージ が含まれています。
packages/
├── core/ # 共有タイプ、ユーティリティ、設定
├── trading/ # CEX取引所統合
│ ├── binance/ # Binanceスポットと先物
│ ├── binance-us/ # Binance US
│ └── bybit/ # Bybit取引所 (ethancod1ng) ⭐ 新機能
├── market-data/ # 価格、ニュース、分析
│ ├── prices/ # CoinGecko、DexPaprika、CoinMarketCap
│ ├── news/ # CryptoPanic、集約ニュース
│ ├── analytics/ # ウェールトラッキング、恐怖/貪欲指数、Dune
│ ├── predictions/ # AI価格予測
│ ├── crypto-indicators/ # テクニカル分析 (Kukapay) ⭐ 新機能
│ ├── crypto-sentiment/ # センチメント分析 (Kukapay) ⭐ 新機能
│ ├── crypto-feargreed/ # 恐怖と貪欲指数 (Kukapay) ⭐ 新機能
│ ├── cryptopanic/ # ニュース集約 (Kukapay)
│ └── coinmarketcap/ # CMC API (Shinzo Labs) ⭐ 新機能
├── defi/ # オンチェーンDeFiツール (60以上のネットワーク!)
│ ├── protocols/ # EVM MCPサーバー (360⭐)、Sperax、DEX
│ │ ├── algorand/ # Algorandツール (GoPlausible) ⭐ 新機能
│ │ └── bsc-ops/ # BSC操作 (TermiX) ⭐ 新機能
│ ├── chain-tools/ # BNBチェーン、オンチェーンMCP
│ └── agents/ # 自律的なDeFiエージェント
├── wallets/ # ウォレット管理
│ ├── evm/ # イーサリアムとEVMウォレット
│ └── solana/ # ソルナウォレット
├── payments/ # 支払いインフラストラクチャ
│ └── x402/ # x402プロトコル、USDC転送
├── automation/ # ボットと自動化
│ ├── social/ # XActions Twitter自動化
│ ├── sweep/ # ダストスイープ
│ └── volume/ # ボリュームツール
└── generators/ # MCPサーバーを構築するためのメタツール
├── abi-to-mcp/ # ABIをMCPツールに変換
├── repo-to-mcp/ # GitHubリポジトリ → MCPサーバー
├── doc-extractor/ # LLMs用のドキュメントを抽出
├── registry/ # Lyraツールレジストリ
└── discovery/ # ツールの発見と検索
📖 パッケージドキュメントを表示 →
統合されたコミュニティMCPサーバー
このリポジトリは、適切な帰属を持つ最高のMITライセンスのクリプトMCPプロジェクトを統合しています。
| プロジェクト | 作者 | カテゴリ | 説明 |
|---|---|---|---|
| evm-mcp-server | mcpdotdirect | defi | 60以上のネットワーク、22以上のツール |
| crypto-indicators-mcp ⭐ 新機能 | Kukapay | market-data | テクニカル指標 (RSI、MACD、ボリンジャーバンド) |
| crypto-sentiment-mcp ⭐ 新機能 | Kukapay | market-data | マルチソースのセンチメント分析 |
| crypto-feargreed-mcp ⭐ 新機能 | Kukapay | market-data | 恐怖と貪欲指数 |
| cryptopanic-mcp-server | Kukapay | market-data | クリプトニュース集約 |
| coinmarketcap-mcp ⭐ 新機能 | Shinzo Labs | market-data | 完全なCMC API |
| whale-tracker-mcp | Kukapay | analytics | 大規模ウォレットの追跡 |
| mcp-web3-stats | crazyrabbitLTC | analytics | Dune Analytics統合 |
| dexpaprika-mcp | CoinPaprika | prices | DEX価格データ |
| algorand-mcp ⭐ 新機能 | GoPlausible | blockchain | 40以上のAlgorandツール |
| bybit-mcp-server ⭐ 新機能 | ethancod1ng | exchange | Bybit API統合 |
| bsc-mcp ⭐ 新機能 | TermiX | defi | BSC操作とセキュリティ |
| onchain-mcp | Bankless | defi | オンチェーンツール |
| mcp-free-usdc-transfer | MagnetAI | payments | 無料のUSDC転送 |
すべての統合プロジェクトは、元のMITライセンスを維持し、完全な帰属があります。
詳細な帰属と変更内容については、CONTRIBUTORS.md を参照してください。
サポートされているネットワーク
EVMチェーン
- イーサリアム、BNBスマートチェーン (BSC)、ポリゴン、アービトラム、Base、オプティミズム
- アバランチェ、ファントム、zkSync Era、Linea、Scroll、Blast、Mode、Mantle
- opBNB + すべてのテストネット
マルチチェーン (新機能)
- Cosmos/IBC - ATOM、OSMO、JUNO、INJなど
- ニアプロトコル - NEARネイティブ + コントラクト
- スイ - Moveサポート付きのSUI
- アプトス - Moveサポート付きのAPT
- ビットコイン、ライトコイン、ソルナ、TON、XRP、THORChain
機能
- 🔄 スワップ/DEX - 1inch、0x、ParaSwapを介したトークンスワップ
- 🌉 ブリッジ - LayerZero、Stargate、Wormholeを介したクロスチェーン転送
- ⛽ ガス - チェーン全体のガス価格、EIP-1559の提案
- 📦 マルチコール - バッチ読み取り/書き込み操作
- 📊 イベント/ログ - 過去のイベントをクエリし、ログをデコード
- 🔒 セキュリティ - ラグプル検出、ホニーポットチェック、GoPlusトークン/アドレスセキュリティ、dAppフィッシング検出
- 💰 ステーキング - 流動性ステーキング (Lido)、LPファーミング
- ✍️ 署名 - メッセージに署名、署名を検証、EIP-712
- 🏦 貸出 - Aave/Compoundのポジション、借入金利
- 📈 価格フィード - 過去の価格、TWAP、オラクル集約
- 📁 ポートフォリオ - チェーン全体の保有量を追跡
- 🏛️ ガバナンス - Snapshot投票、オンチェーン提案
- 🚀 デプロイメント - コントラクトをデプロイ、CREATE2、アップグレード可能なプロキシ、検証
- 🛡️ MEV保護 - Flashbots Protect、プライベートトランザクション、バンドルシミュレーション
- 🆔 ENS/ドメイン - 登録、転送、更新、レコード設定、サブドメイン
- 📊 市場データ - CoinGeckoとCoinStatsの価格、OHLCV、トレンド、カテゴリ、取引所
- 🌐 DeFi分析 - DefiLlamaのTVL、収益、手数料、ブリッジ、安定コイン、プロトコルデータ
- 💬 ソーシャルセンチメント - LunarCrushのソーシャルメトリクス、インフルエンサー、トレンドトピック
- 📈 DEX分析 - DexPaprikaとGeckoTerminalのプール、取引、OHLCV、トレンドトークン
- 🔮 予測 - Polymarketの予測市場、クリプト予測
- 📉 テクニカル指標 - 50以上の指標 (RSI、MACD、ボリンジャーバンドなど)
- 🔔 アラート - 価格アラート、ウェールの動きアラート、ガスアラート (新機能)
- 📡 WebSockets - リアルタイムの価格ストリーム、取引フィード、メムプール監視 (新機能)
- 🐋 ウォレット分析 - ウェールトラッキング、ウォレットスコアリング、行動分析 (新機能)
- 🌐 マルチチェーン - Cosmos、ニア、スイ、アプトスのネイティブサポート (新機能)
- 💰 x402支払い - AIエージェントが自動的にプレミアムAPIに支払うことができる (新機能)
💰 x402支払いプロトコル (新機能!)
Claudeにお金を与えましょう! AIエージェントが暗号通貨の支払いを行ったり受け取ったりできるようになりました。
x402とは何か?
x402はHTTP 402 Payment Requiredを実装し、AIエージェントが以下のことを可能にします。
- 💸 APIに支払う - 自動的にプレミアムAPIアクセスに支払う
- 🤖 自律的な支払い - 人間の承認が不要
- 🏦 資金を保有 - エージェントが独自の暗号通貨ウォレットを持つ
- 📈 収益を得る - 支払いにはUSDs安定コインを使用 (約5%のAPY自動収益)
クイックセットアップ
# 環境に追加
export X402_PRIVATE_KEY=0x... # あなたのEVM秘密鍵
export X402_CHAIN=arbitrum # デフォルトのチェーン (またはbase、ethereum、polygon)
x402ツール (合計14個)
| ツール | 説明 |
|---|---|
x402_pay_request |
自動402支払いでHTTPリクエストを行う |
x402_balance |
ウォレットの残高 (USDC/USDs + ネイティブ) を確認する |
x402_send |
アドレスに直接支払いを送信する |
x402_batch_send |
1つのトランザクションで複数の支払いを送信する |
x402_gasless_send |
ガスを支払わずに支払いを送信する |
x402_estimate |
支払う前にコストを確認する |
x402_address |
あなたのウォレットアドレスを取得する |
x402_networks |
サポートされているネットワークをリストする |
x402_yield |
USDsの自動収益を確認する |
x402_apy |
現在のAPYレートを取得する |
x402_yield_estimate |
将来の収益を予測する |
x402_approve |
トークンの支出を承認する |
x402_tx_status |
トランザクションのステータスを確認する |
x402_config |
現在の設定を表示する |
サポートされているネットワーク
| ネットワーク | CAIP-2 | ステータス |
|---|---|---|
| Base | eip155:8453 |
✅ 推奨 |
| アービトラム | eip155:42161 |
✅ サポートされている |
| イーサリアム | eip155:1 |
✅ サポートされている |
| ポリゴン | eip155:137 |
✅ サポートされている |
| ソルナ | solana:mainnet |
✅ サポートされている |
例
ユーザー: "東京のプレミアム天気データを取得して"
エージェント: [天気APIにx402_pay_requestを呼び出す]
[自動的に $0.01 USDsを支払う]
"こちらが詳細な予報です..."
x402アーキテクチャ
┌─────────┐ ┌───────────┐ ┌───────────┐
│ Claude │─────▶│ MCP Server│─────▶│ Paid API │
│ (AI) │ │ (x402) │ │ (402) │
└─────────┘ └───────────┘ └───────────┘
│ │ │
│ "Get data" │ HTTP + Payment │
│ │ │
└────────────────┴───────────────────┘
📖 完全なドキュメント:
- x402 README - 概要とクイックスタート
- クイックスタートガイド - 5分でのセットアップ
- MCPツールリファレンス - すべての14個のツールの説明
- アーキテクチャ - 技術的な詳細
- 例 - 実際のユースケース
- セキュリティガイド - ベストプラクティス
🚀 クイックスタート
Claudeデスクトップ
claude_desktop_config.json に追加します。
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
"env": {
"PRIVATE_KEY": "あなたの秘密鍵 (オプション)"
}
}
}
}
Cursor
MCP設定に追加します。
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
"env": {
"PRIVATE_KEY": "あなたの秘密鍵 (オプション)"
}
}
}
}
ChatGPT開発者モード
- ChatGPT設定で 開発者モード を有効にします。
- HTTPサーバーを起動します。
npx @nirholas/universal-crypto-mcp@latest --http - ChatGPT設定 → アプリで、アプリを作成 をクリックします。
- サーバーURLを入力します:
http://localhost:3001/mcp - 会話で 開発者モード メニューからアプリを選択します。
詳細なセットアップ手順については、ChatGPTセットアップガイド を参照してください。
サーバーモード
| モード | コマンド | 使用例 |
|---|---|---|
| stdio | npx @nirholas/universal-crypto-mcp |
Claudeデスクトップ、Cursor |
| HTTP | npx @nirholas/universal-crypto-mcp --http |
ChatGPT開発者モード |
| SSE | npx @nirholas/universal-crypto-mcp --sse |
レガシーHTTPクライアント |
💬 サンプルプロンプト (コピー&ペースト!)
Claude、ChatGPT、またはCursorで使用できる実際のプロンプトです。コピーしてペーストしてください!
🔄 トークンスワップ
アービトラムで0.1 ETHをUSDCに交換する
Baseで100 USDCをWBTCに交換する見積もりを取得する
イーサリアム上のすべてのDEXで500 DAIをETHに交換する最良のレートは何か?
📊 市場データと価格
現在のビットコインとイーサリアムのUSD価格は何か?
現在CoinGeckoでトレンドのある上位10のコインを表示する
ソルナの7日間のOHLCVデータを取得する
BNBの時価総額と24時間の取引量は何か?
イーサリアム上のトークン0xdAC17F958D2ee523a2206206994597C13D831ec7の価格を表示する
🌐 DeFi分析 (DefiLlama)
すべてのチェーンでのAaveの総TVLは何か?
TVLで上位10のプロトコルを表示する
現在の安定コインの最高の収益機会は何か?
ブリッジが過去24時間で処理した取引量はいくらか?
過去30日間のUniswapのTVL履歴を表示する
📈 DEX分析
Uniswap V3でトレンドのある上位のプールを表示する
過去24時間でBaseで最も取引されたトークンを取得する
イーサリアム上のPEPEのすべての流動性プールを見つける
AerodromeのETH/USDCプールの価格と流動性は何か?
🔒 セキュリティチェック
このトークンは安全ですか? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE (SHIB)
このトークンがホニーポットかどうかを確認する: 0x... on BSC
私のウォレットの危険な承認をスキャンする: 0xYourAddress
このdAppのURLに接続するのは安全ですか? https://suspicious-site.xyz
💰 ステーキングと貸出
LidoでのETHの現在のステーキングAPYは何か?
アービトラムでのAaveのUSDC貸出金利を表示する
2 ETHを担保に1000 USDCを借りた場合、Aaveでの私の健全性係数は何か?
🌉 クロスチェーンブリッジ
イーサリアムからアービトラムに100 USDCをブリッジする
メインネットからBaseにETHをブリッジする最安の方法は何か?
ポリゴンからオプティミズムに0.5 ETHをブリッジする見積もりを取得する
⛽ ガスとネットワーク
イーサリアムの現在のガス価格は何か?
すべてのサポートされているチェーンのEIP-1559ガス料金を取得する
現在アービトラムでの取引は安いですか?
🏛️ ガバナンス
Uniswapでのアクティブな提案を表示する
Compoundでの私の投票権は何か?
最新のAaveガバナンス投票の結果を取得する
💬 ソーシャルセンチメント (LunarCrush)
現在のビットコインのソーシャルセンチメントは何か?
ソーシャルメディアでの上位のクリプトインフルエンサーを表示する
今日Twitter/Xでトレンドのあるトークンは何か?
イーサリアムのGalaxyスコアを取得する
🆔 ENSドメイン
vitalik.ethをアドレスに解決する
ENSドメイン "ethereum.eth" の所有者は誰か?
ドメインmycoolname.ethを1年間登録する
📰 クリプトニュース
最新のクリプトニュースを取得する
ビットコインETFに関するニュースを検索する
DeFiでのブレーキングニュースは何か?
📁 ポートフォリオとウォレット
イーサリアム上の私のトークン残高を表示する: 0xYourAddress
vitalik.ethが所有するすべてのNFTを取得する
私のウォレットから承認した承認をすべて取得する
すべてのEVMチェーンでの私のポートフォリオを追跡する
🚀 高度な操作
Base上で100万の供給量を持つ新しいERC-20トークン "MyToken" (MTK) をデプロイする
Flashbotsを介してこのトランザクションをプライベートに送信してMEVを回避する
100 USDCの転送関数への呼び出しをエンコードする
このトランザクションを実行する前にシミュレートする: 0x...
📉 テクニカル指標
過去14日間のビットコインのRSIを計算する
4時間足でのETH/USDTのMACDシグナルを取得する
20期間のSMAでのSOLのボリンジャーバンドを表示する
複数の指標を使用したBTCの現在のトレンドシグナルは何か?
DOGEに対するモメンタム戦略分析を実行する
🔮 予測市場
Polymarketでの上位のクリプト予測市場は何か?
ビットコインの価格予測を検索する
ETHが5000ドルに達する現在のオッズは何か?
📊 イベントとログ
イーサリアム上の過去100ブロックでのUSDCのすべてのTransferイベントを取得する
私のウォレットアドレスのApprovalイベントを表示する
このトランザクションログをデコードする: 0x...
✍️ 署名とメッセージ
私のウォレットでこのメッセージに署名する: "Hello World"
この署名がvitalik.ethからのものであることを検証する
許可のためのEIP-712タイプのデータ署名を作成する
📦 バッチ操作 (マルチコール)
1回の呼び出しで10個の異なるトークンの残高を取得する
Aaveから複数のコントラクト値を一度に読み取る
私が承認したすべてのトークンの許可を一括でチェックする
🧪 テスト
私たちはテストフレームワークとして Vitest を使用し、包括的なテストカバレッジを持っています。
テストの実行
# すべての単体テストを実行
npm test
# ファイルの変更があったときに再実行するウォッチモードでテストを実行
npm run test:watch
# カバレッジレポート付きでテストを実行
npm run test:coverage
# E2Eテストを実行 (ネットワークアクセスが必要)
npm run test:e2e
# ウォッチモードでE2Eテストを実行
npm run test:e2e:watch
# インタラクティブなテストUIを開く
npm run test:ui
MCPインスペクター
公式の MCPインスペクター を使用して、MCPツールを対話的にテストできます。
npm run test:inspector
これにより、ブラウザベースのUIが開き、以下のことができます。
- 利用可能なすべてのツールとプロンプトを閲覧する
- カスタムパラメータでツールの実行をテストする
- ツールの応答を表示し、問題をデバッグする
- MCPサーバーの実装を検証する
テスト構造
tests/
├── setup.ts # グローバルなテストセットアップ
├── e2e/ # エンドツーエンドテスト
│ ├── evm-tools.e2e.test.ts
│ └── market-data.e2e.test.ts
├── integration/ # 統合テスト
│ ├── evm-tools.test.ts
│ └── multichain.test.ts
└── mocks/ # テストモックとフィクスチャ
src/
├── evm/
│ ├── chains.test.ts # ソースコードと並行した単体テスト
│ └── modules/
│ └── */tools.test.ts
└── utils/
├── errors.test.ts
├── helper.test.ts
└── validation.test.ts
ローカル開発
# クローン
git clone https://github.com/nirholas/universal-crypto-mcp
cd universal-crypto-mcp
# インストール
npm install
# 開発サーバーを実行 (stdio - Claude)
npm run dev
# 開発サーバーを実行 (HTTP - ChatGPT)
npm run dev:http
# 開発サーバーを実行 (SSE - レガシー)
npm run dev:sse
🧪 テスト
テストの実行
# すべてのテストを実行
npm test
# 単体テストのみを実行
npm run test:unit
# 統合テストを実行
npm run test:integration
# E2Eテストを実行 (ネットワークアクセスが必要)
npm run test:e2e
# カバレッジレポート付きでテストを実行
npm run test:coverage
# 開発時にウォッチモードでテストを実行
npm run test:watch
テスト構造
| タイプ | 場所 | 説明 |
|---|---|---|
| 単体 | src/**/*.test.ts |
個々の関数/モジュールをテスト |
| 統合 | tests/integration/ |
複数のコンポーネントを一緒にテスト |
| E2E | tests/e2e/ |
完全なMCPサーバーのフローをテスト |
E2Eテスト
エンドツーエンドテストは、完全なツール実行フローを検証します。
- EVMツール - チェーン全体のブロック、残高、トークン操作
- DeFiツール - DefiLlamaを介したプロトコルのTVL、収益、安定コイン
- 市場データ - CoinGecko、恐怖と貪欲指数
- マルチチェーン - 異なるネットワークでの同じ操作
- エラー回復 - エラー処理、無効な入力、エッジケース
カスタムテストユーティリティ
このプロジェクトには、MCP応答用のカスタムVitestマッチャーが含まれています。
// テストファイル内
import "../utils/assertions"
expect(result).toBeSuccessfulToolResponse()
expect(result).toHaveJsonProperty("balance")
expect(result).toContainValidAddress()
expect(result).toContainToolError(/invalid/i)
テストフィクスチャ
tests/utils/fixtures.ts に再利用可能なテストデータがあります。
import {
ETH_MAINNET_ADDRESSES,
MOCK_TOKEN_DATA,
generateRandomAddress
} from "../utils/fixtures"
詳細なテストドキュメントについては、tests/README.md を参照してください。
⚙️ 環境変数
拡張機能のためにオプションのAPIキーを設定します。.env ファイルを作成します。
# 書き込み操作 (スワップ、転送など) に必要
PRIVATE_KEY=あなたの秘密鍵
# 市場データ (オプション - 無料枠あり)
COINGECKO_API_KEY=あなたのキー # https://coingecko.com/api
COINSTATS_API_KEY=あなたのキー # https://coinstats.app
# ソーシャルセンチメント (オプション)
LUNARCRUSH_API_KEY=あなたのキー # https://lunarcrush.com/developers
# ニュース (オプション)
CRYPTOPANIC_API_KEY=あなたのキー # https://cryptopanic.com/developers
# クロスチェーンスワップ (オプション)
RUBIC_API_KEY=あなたのキー # https://rubic.exchange
# カスタムRPCエンドポイント (オプション - デフォルトではパブリックRPCを使用)
ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
BASE_RPC_URL=https://mainnet.base.org
APIキーなしで動作する機能
| 機能 | APIキーなし | APIキーあり |
|---|---|---|
| トークン価格 | ✅ CoinGeckoの無料枠 | ✅ より高いレート制限 |
| DeFi分析 | ✅ DefiLlama (無料) | - |
| セキュリティチェック | ✅ GoPlus (無料) | - |
| DEX分析 | ✅ GeckoTerminal (無料) | - |
| ソーシャルセンチメント | ❌ | ✅ LunarCrush |
| クリプトニュース | ❌ | ✅ CryptoPanic |
| クロスチェーンスワップ | ✅ 基本的なもの | ✅ 最適なルート |
ドキュメント
https://mcp.giving
📖 ドキュメントとサンプル
📖 ドキュメント
包括的なガイドとAPIリファレンスです。
-
はじめに
- インストールガイド
- 設定
- 最初のMCPツール
- デプロイメントガイド
-
パッケージドキュメント
- コアパッケージ
- 取引
- 市場データ
- ウォレット
- DeFi
- 支払い (x402)
-
x402デプロイドキュメント
- 概要
- クイックスタート
- 設定
- プロバイダー
- 発見
-
貢献
- 開発ガイド
- テスト
- リリース
💻 サンプル
実行して変更できる動作コードサンプルです。
- 基本的なMCPサーバー - 市場データツールを備えた最小限のMCPサーバー
- 有料APIサンプル - Express APIにx402支払いを追加
- 取引ボット - RSI + MA戦略を備えた自動取引ボット
- 完全なデプロイメント - すべての機能を備えた本番環境向けサーバー
各サンプルには以下が含まれています。
- 完全なソースコード
- セットアップ手順を含むREADME
- パッケージ構成
- 環境設定ガイド
🗺️ ロードマップ
実装予定のすべてのクリプト/ブロックチェーン/DeFi/Web3機能の包括的なロードマップです。
凡例
- ✅ 実装済み
- 🚧 進行中
- 📋 計画中
🔗 コアブロックチェーン操作 (クリックして展開)
🔗 コアブロックチェーン操作
ネットワークとチェーン
| 機能 | ステータス |
|---|---|
| チェーンID、ブロック番号、ガス価格を取得 | ✅ |
| ネットワークのステータス/健全性を取得 | ✅ |
| ネットワーク/チェーンを切り替える | ✅ |
| サポートされているネットワークのリストを取得 | ✅ |
| RPCエンドポイントを取得 | ✅ |
| ブロック時間を推定 | ✅ |
| チェーンメタデータ (名前、シンボル、エクスプローラー) を取得 | ✅ |
| 最終性ステータスを取得 | ✅ |
| メムプール/保留中のトランザクションを取得 | ✅ |
| ネットワークのピア/ノードを取得 | ✅ |
| ガスオラクルを取得 | ✅ |
ブロック
| 機能 | ステータス |
|---|---|
| 番号/ハッシュでブロックを取得 | ✅ |
| 最新のブロックを取得 | ✅ |
| ブロックのトランザクションを取得 | ✅ |
| ブロックのレシートを取得 | ✅ |
| アンクルブロックを取得 | ✅ |
| 新しいブロックを購読 | 📋 |
| ブロック報酬を取得 | ✅ |
| ブロックで使用されたガス/制限を取得 | ✅ |
| ブロック範囲を取得 | ✅ |
| マイナーによるブロックを取得 | ✅ |
トランザクション
| 機能 | ステータス |
|---|---|
| トランザクションを送信 | ✅ |
| ハッシュでトランザクションを取得 | ✅ |
| トランザクションのレシートを取得 | ✅ |
| トランザクションのステータスを取得 | ✅ |
| ガスを推定 | ✅ |
| トランザクションを高速化 (より高いガスで置き換える) | ✅ |
| トランザクションをキャンセル | ✅ |
| トランザクション入力をデコード | ✅ |
| トランザクションをシミュレート | ✅ |
| トランザクショントレースを取得 | 📋 |
| 内部トランザクションを取得 | 📋 |
| バッチトランザクション | ✅ |
| 保留中のトランザクションを取得 | ✅ |
| アドレスによるトランザクション履歴を取得 | ✅ |
アカウント/ウォレット
| 機能 | ステータス |
|---|---|
| 残高 (ネイティブ/トークン) を取得 | ✅ |
| ノンスを取得 | ✅ |
| トランザクション数を取得 | ✅ |
| ウォレットを作成 | ✅ |
| ウォレットをインポート (秘密鍵/ニーモニック) | ✅ |
| 秘密鍵をエクスポート | 📋 |
| メッセージに署名 | ✅ |
| 署名を検証 | ✅ |
| 秘密鍵からアドレスを取得 | ✅ |
| ニーモニックを生成 | ✅ |
| アドレスを派生 (HDウォレット) | ✅ |
| マルチシグウォレット操作 | 📋 |
| ウォレットの権限を取得 | 📋 |
| 承認を取り消す | ✅ |
| アカウント抽象化 (ERC-4337) | 📋 |
| ソーシャルリカバリー | 📋 |
| ハードウェアウォレット統合 | 📋 |
| ウォレットのポートフォリオを取得 | ✅ |
| トークンの承認を取得 | ✅ |
💰 トークン操作 (クリックして展開)
💰 トークン操作
ネイティブトークン
| 機能 | ステータス |
|---|---|
| ネイティブ残高を取得 | ✅ |
| ネイティブトークンを転送 | ✅ |
| ネイティブトークンをラップ/アンラップ (WETH、WBNB) | ✅ |
ERC-20 (ファンジブルトークン)
| 機能 | ステータス |
|---|---|
| トークン情報 (名前、シンボル、小数点以下桁数、総供給量) を取得 | ✅ |
| トークン残高を取得 | ✅ |
| トークンを転送 | ✅ |
| 支出を承認 | ✅ |
| 許可を取得 | ✅ |
| 委任による転送 | ✅ |
| トークンを燃焼 | ✅ |
| トークンをミント | ✅ |
| トークンの保有者を取得 | ✅ |
| トークンの転送を取得 | ✅ |
| 許可 (ガスレス承認 - EIP-2612) | ✅ |
| バッチ転送 | ✅ |
| トークンスナップショット | 📋 |
| トークンの供給情報を取得 | ✅ |
| トークンの承認をチェック/取り消す | ✅ |
ERC-721 (NFT)
| 機能 | ステータス |
|---|---|
| NFTメタデータを取得 | ✅ |
| NFTの所有者を取得 | ✅ |
| NFTを転送 | ✅ |
| NFTを承認 | ✅ |
| すべての承認を設定 | ✅ |
| 所有者によるNFTを取得 | ✅ |
| NFTコレクション情報を取得 | ✅ |
| NFTをミント | 📋 |
| NFTを燃焼 | 📋 |
| NFTの転送履歴を取得 | 📋 |
| NFTの特性/属性を取得 | ✅ |
| NFTの希少性を取得 | 📋 |
| NFTの真正性を検証 | 📋 |
| NFTをバッチ転送 | ✅ |
| NFTの承認をチェック | ✅ |
| NFTの承認を取り消す | ✅ |
| マーケットプレイスの承認 | ✅ |
| URIからNFTメタデータを取得 | ✅ |
ERC-1155 (マルチトークン)
| 機能 | ステータス |
|---|---|
| トークン残高 (ファンジブル + NFT) を取得 | ✅ |
| バッチ転送 | 📋 |
| バッチ残高クエリ | 📋 |
| 安全な転送 | ✅ |
| URIを取得 | ✅ |
その他のトークン標準
| 機能 | ステータス |
|---|---|
| ERC-777 (高度なファンジブル) | 📋 |
| ERC-3525 (セミファンジブル) | 📋 |
| ERC-4626 (トーク |
代替品














