MCP Crypto API Servers

MCP Crypto API Servers

Repositori ini berisi implementasi Model Context Protocol (MCP) server untuk berbagai API cryptocurrency, termasuk CoinGecko, DeFiLlama, DexScreener, dan Indodax. MCP server ini memungkinkan AI untuk berinteraksi dengan data cryptocurrency secara real-time.

Daftar Isi

• Pendahuluan
• Fitur
• Persyaratan
• Instalasi
• Penggunaan
• Server yang Tersedia
  • CoinGecko
  • DeFiLlama
  • DexScreener
  • Indodax
  • Moralis Solana
• Konfigurasi
• Kontribusi
• Lisensi

Pendahuluan

Model Context Protocol (MCP) adalah standar yang menghubungkan sistem AI dengan alat dan sumber data eksternal. Proyek ini menyediakan server MCP untuk API cryptocurrency populer, memungkinkan AI untuk mengakses data pasar crypto secara real-time, termasuk harga, volume, TVL (Total Value Locked), dan metrik lainnya.

Fitur

• Akses data cryptocurrency real-time melalui API publik
• Format output markdown yang konsisten dan mudah dibaca
• Penanganan error yang robust
• Implementasi untuk tiga API cryptocurrency utama:
  • CoinGecko: Data harga, market, dan detail koin
  • DeFiLlama: Data TVL, stablecoin, dan yield
  • DexScreener: Data DEX, pair trading, dan token

Persyaratan

• Python 3.9+
• FastMCP
• Dependensi lain (lihat requirements.txt)

Instalasi

1. Clone repositori ini:

2. Buat dan aktifkan virtual environment:

3. Instal dependensi:

Penggunaan

Untuk menjalankan semua server MCP:

Untuk menjalankan server tertentu:

Server yang Tersedia

CoinGecko

Server MCP CoinGecko menyediakan akses ke API CoinGecko v3 dengan fungsi-fungsi berikut:

Fungsi Coin API

• get_coin_list - Mendapatkan daftar semua koin yang didukung
• get_coin_price - Mendapatkan harga koin dalam berbagai mata uang
• get_coin_detail - Mendapatkan data lengkap koin
• get_coin_market_chart - Mendapatkan data historis market untuk koin
• get_trending_coins - Mendapatkan koin trending dalam 24 jam terakhir
• search_coins - Mencari koin, kategori, dan market
• get_coin_markets - Mendapatkan daftar koin dengan data market
• get_coin_categories - Mendapatkan daftar semua kategori koin
• get_coin_category_details - Mendapatkan data market untuk kategori koin tertentu
• get_coin_market_chart_range - Mendapatkan data historis market dalam rentang waktu
• get_coin_tickers - Mendapatkan data ticker untuk koin tertentu
• get_coin_ohlc - Mendapatkan data OHLC untuk koin

Fungsi Market API

• get_global_data - Mendapatkan data global market cryptocurrency
• get_top_gainers_losers - Mendapatkan top gainers dan losers dalam periode tertentu

Fungsi NFT API

• get_nfts - Mendapatkan daftar koleksi NFT dengan data market
• get_nft_detail - Mendapatkan data detail untuk koleksi NFT tertentu

Fungsi Exchange API

• get_exchanges - Mendapatkan daftar semua exchange
• get_exchange_detail - Mendapatkan data detail untuk exchange tertentu

Fungsi Simple API

• get_supported_vs_currencies - Mendapatkan daftar mata uang yang didukung

Fungsi Utilitas

• ping - Memeriksa apakah server API CoinGecko berjalan

DeFiLlama

Server MCP DeFiLlama menyediakan akses ke API DeFiLlama dengan fungsi-fungsi berikut:

Fungsi TVL

• get_all_protocols - Mendapatkan daftar semua protokol
• get_protocol_tvl - Mendapatkan TVL saat ini untuk protokol tertentu
• get_historical_tvl_protocol - Mendapatkan TVL historis untuk protokol tertentu
• get_historical_tvl_chain - Mendapatkan TVL historis untuk chain tertentu
• get_historical_tvl_all_chains - Mendapatkan TVL historis untuk semua chain
• get_current_tvl_all_chains - Mendapatkan TVL saat ini untuk semua chain
• get_tvl_protocol - Mendapatkan TVL saat ini (endpoint sederhana)

Fungsi Harga Koin

• get_historical_coin_prices - Mendapatkan harga historis dalam rentang waktu
• get_current_coin_price - Mendapatkan harga koin saat ini
• get_historical_coin_price_at_timestamp - Mendapatkan harga historis pada timestamp
• get_batch_historical_prices - Mendapatkan harga historis untuk beberapa token
• get_percentage_change - Mendapatkan persentase perubahan harga koin

Fungsi Stablecoin

• get_stablecoins - Mendapatkan daftar semua stablecoin
• get_stablecoins_by_peg_type - Mendapatkan daftar stablecoin berdasarkan peg
• get_stablecoin_charts_by_chain - Mendapatkan historical mcap stablecoin
• get_stablecoin_by_asset - Mendapatkan historical mcap dan distribusi chain
• get_stablecoin_chains - Mendapatkan mcap saat ini di setiap chain
• get_stablecoin_prices - Mendapatkan harga saat ini dari semua stablecoin

Fungsi Lainnya

• get_block_by_timestamp - Mendapatkan nomor blok terdekat dengan timestamp
• get_yields_pools - Mendapatkan daftar semua pool yield
• get_yields_pool - Mendapatkan informasi detail tentang pool yield
• get_volumes_overview_dexs - Mendapatkan overview volume DEX
• get_fees_overview - Mendapatkan overview fees dan revenue

DexScreener

Server MCP DexScreener menyediakan akses ke API DexScreener dengan fungsi-fungsi berikut:

• search_pairs - Mencari trading pair berdasarkan simbol atau alamat
• get_pair - Mendapatkan informasi pair berdasarkan chain dan alamat (GET /dex/pairs/{chainId}/{pairAddress})
• get_pairs_by_token - Mendapatkan semua trading pair untuk token tertentu (GET /dex/tokens/{tokenAddresses})

Semua fungsi diimplementasikan sesuai dengan spesifikasi API yang terdapat dalam doc/dexscreener_api_json.json.

Indodax

Server MCP Indodax menyediakan akses ke API Indodax untuk trading dan informasi pasar dengan fungsi-fungsi berikut:

Fungsi Informasi Pasar

• ticker - Mendapatkan ticker untuk pasangan tertentu
• ticker_all - Mendapatkan ticker untuk semua pasangan
• trades - Mendapatkan transaksi terbaru untuk pasangan tertentu
• summaries - Mendapatkan ringkasan untuk semua pasangan
• server_time - Mendapatkan waktu server
• pairs - Mendapatkan daftar pasangan trading yang tersedia
• price_increments - Mendapatkan increment harga per pasangan

Fungsi Trading

• get_info - Mendapatkan informasi saldo, waktu server, alamat, dll
• trade - Membuat order beli/jual
• open_orders - Mendapatkan order yang masih aktif
• order_history - Mendapatkan riwayat order
• get_order - Mendapatkan order berdasarkan ID numerik
• get_order_by_client_order_id - Mendapatkan order berdasarkan ID klien
• cancel_order - Membatalkan order berdasarkan ID numerik
• cancel_by_client_order_id - Membatalkan order berdasarkan ID klien
• trade_history - Mendapatkan riwayat transaksi
• trans_history - Mendapatkan riwayat transaksi antara dua tanggal

Fungsi Referral dan Voucher

• check_downline - Memeriksa apakah username adalah downline Anda
• list_downline - Mendapatkan daftar downline referral (Partner only)
• create_voucher - Membuat voucher (Partner only)

Fungsi Withdrawal

• withdraw_coin - Melakukan penarikan crypto
• withdraw_fee - Mengestimasi biaya penarikan

Moralis Solana

Server MCP Moralis Solana menyediakan akses ke API Moralis untuk blockchain Solana dengan fungsi-fungsi berikut:

Fungsi Token API

• get_token_metadata - Mendapatkan metadata token Solana (nama, simbol, desimal, dan supply)
• get_token_price - Mendapatkan harga token dalam USD dan SOL
• get_multiple_token_prices - Mendapatkan harga untuk beberapa token sekaligus
• get_token_balances - Mendapatkan saldo token untuk alamat wallet
• get_token_pairs - Mendapatkan data pasangan trading dan likuiditas untuk token
• get_token_swaps - Mendapatkan transaksi swap untuk token
• get_pump_fun_tokens - Mendapatkan data token Pump.fun (status, market cap, volume)
• get_pump_fun_token_price - Mendapatkan data harga khusus untuk token Pump.fun

Fungsi NFT API

• get_wallet_nfts - Mendapatkan semua NFT yang dimiliki oleh wallet
• get_nft_transfers - Mendapatkan riwayat transfer untuk NFT tertentu
• search_nfts - Mencari NFT berdasarkan kriteria metadata (nama, deskripsi, atribut)

Fungsi Wallet API

• get_native_balance - Mendapatkan saldo SOL native untuk alamat wallet
• get_portfolio - Mendapatkan portfolio wallet termasuk token, NFT, dan saldo native
• get_wallet_token_transfers - Mendapatkan riwayat transfer token untuk wallet
• get_wallet_nft_transfers - Mendapatkan riwayat transfer NFT untuk wallet
• get_wallet_swaps - Mendapatkan riwayat transaksi swap untuk wallet

Fungsi Price API

• get_token_price_history - Mendapatkan data historis harga untuk token dengan interval (1h, 6h, 24h)
• get_ohlcv_by_token - Mendapatkan data OHLCV candlestick untuk token dengan berbagai timeframe (1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w)

Konfigurasi

Konfigurasi API key dan pengaturan lainnya dapat dilakukan melalui file .env atau dengan mengedit file konfigurasi server secara langsung.

Contoh file .env:

File konfigurasi MCP (mcp_config.json) telah dibuat di direktori proyek untuk menambahkan server-server yang diimplementasikan.

Kontribusi

Kontribusi sangat diterima! Jika Anda ingin berkontribusi pada proyek ini:

1. Fork repositori
2. Buat branch fitur (git checkout -b feature/amazing-feature)
3. Commit perubahan Anda (git commit -m 'Add some amazing feature')
4. Push ke branch (git push origin feature/amazing-feature)
5. Buka Pull Request

Lisensi

Didistribusikan di bawah Lisensi MIT. Lihat LICENSE untuk informasi lebih lanjut.