Web3 Research MCP

Kripto için Derin Araştırma - ücretsiz ve tamamen lokal 🧠

🚀 Önizleme

🧠 Özellikler

• Kapsamlı Araştırma: Herhangi bir kripto para token'ı hakkında detaylı bilgi toplayın
• Çok Kaynaklı Analiz: CoinGecko, CoinMarketCap, DeFiLlama ve daha fazlası dahil olmak üzere birden fazla kaynakta araştırma yapın
• Yapılandırılmış Raporlama: Teknik temel bilgiler, pazar verileri, sosyal sentiment ve daha fazlasını kapsayan detaylı raporlar oluşturun
• Kaynak Yönetimi: Arama sonuçlarını ve içeriği referans için otomatik olarak saklayın
• Durum İzleme: Araştırma ilerlemeşini farklı aşama ve bölümler aracılığıyla takip edin

📋 Gereksinimler

• Node.js (v16 veya daha yüksek)

🔧 Kurulum ve Ayarlama

Smithery Üzerinden Kurulum

Web3-research-mcp'yi Claude Desktop'a Smithery aracılığıyla otomatik olarak kurmak için:

npx -y @smithery/cli install web3-research-mcp --client claude

🔌 Claude Desktop ile Kullanım

Claude Desktop config dosyanızı düzenleyin

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Desktop konfigürasyon dosyanıza bunu ekleyin:

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Ardından Claude Desktop'ı yeniden başlatın

🔌 Cursor ile Kullanım

Şuraya gidin: Settings -> Cursor Settings -> MCP -> Add new global MCP server Bunu Cursor ~/.cursor/mcp.json dosyasına yapıştırın. Daha fazla bilgi için Cursor MCP docs'a bakın.

{
  "mcpServers": {
    "web3-research-mcp": {
      "command": "npx",
      "args": ["-y", "web3-research-mcp@latest"]
    }
  }
}

Ardından Cursor'ı yeniden başlatın

🛠️ Tools

create-research-plan

Bir token için yapılandırılmış bir araştırma planı oluşturur.

Parametreler:

• tokenName: Token'ın tam adı
• tokenTicker: Token'ın ticker sembolü

search

Web araması gerçekleştirir ve sonuçları döndürür.

Parametreler:

• query: Arama sorgusu
• searchType: Arama türü (web, news, images, videos)

research-with-keywords

Belirli anahtar kelimelerle bir token'ı arar ve sonuçları kaydeder.

Parametreler:

• tokenName: Token'ın adı
• tokenTicker: Ticker sembolü
• keywords: Aranacak anahtar kelimeler dizisi

update-status

Bir araştırma bölümünün durumunu günceller.

Parametreler:

• section: Güncellenecek bölüm adı (örn. 'projectInfo', 'technicalFundamentals')
• status: Bölümün yeni durumu (planned, in_progress, completed)

fetch-content

Bir URL'den içerik getirir ve onu bir kaynak olarak kaydeder.

Parametreler:

• url: İçerik getirilecek URL
• format: Çıktı formatı (text, html, markdown, json)

list-resources

Kaydedilmiş tüm kullanılabilir kaynakları listeler.

search-source

Belirli bir kaynaktan bir token hakkında bilgi arar.

Parametreler:

• tokenName: Token'ın adı
• tokenTicker: Ticker sembolü
• source: Aranacak kaynak (örn. 'CoinGecko', 'DeFiLlama', 'News')

coingecko-data

CoinGecko public API'sinden doğrudan canlı pazar verilerini getirir — fiyat, pazar başkenti, 24s/7g/30g değişimleri, ATH/ATL, dolaşımdaki arz, zincirler arasında contract adresleri ve sosyal/dev bağlantıları. HTML scraping'in 403 sorunlarını ortadan kaldırır.

Parametreler:

• tokenName: Token'ın tam adı (örn. 'Bitcoin')
• tokenTicker: Ticker sembolü (örn. 'BTC')

API anahtarı gerekli değildir. Ücretsiz public tier'ı kullanır (~30 req/min).

İsteğe bağlı: CoinGecko Pro API anahtarını kullanmak için ortam değişkeninde COINGECKO_API_KEY ayarlayın. Ayarlandığında, istekler x-cg-pro-api-key header'ı ile https://pro-api.coingecko.com/api/v3'e gönderilir. İstekler 15 saniye sonra timeout olur.

coingecko-search

CoinGecko'nun coin index'ini arar ve CoinGecko ID'leri ile aday eşleşmeleri döndürür. Ticker belirsiz olduğunda (örn. aynı sembolü olan birden fazla token) kullanışlıdır.

Parametreler:

• query: Arama sorgusu — ad, ticker veya contract adresi

coingecko-tickers

CoinGecko'dan bir token için aktif exchange listelerini getirir — hangi CEX'ler/DEX'ler çifti işlem görür, venue başına 24s USD hacmi, son fiyat, bid-ask spread, trust score ve işlem URL'si. 24s USD hacmine göre azalan sırada sıralanır; anormallikler ve eski printler filtrelenir. "Bu token gerçekten nerede işlem görüyor" sorusuna HTML scraping'i ortadan kaldırır.

Parametreler:

• tokenName: Token'ın tam adı (örn. 'Bitcoin')
• tokenTicker: Ticker sembolü (örn. 'BTC')
• limit: Döndürülecek en iyi venue sayısı (varsayılan 15, maksimum 50)

API anahtarı gerekli değildir. Ücretsiz public tier'ı kullanır. İstekler 15 saniye sonra timeout olur.

defillama-data

DeFiLlama public API'sinden doğrudan protocol verilerini getirir — toplam TVL, chain başına TVL dökümü, ücretler (24s/7g/30g/all-time), token adresleri, fundraising turları ve bağlantılar. En yaygın DeFi-protocol araması için HTML scraping'i ortadan kaldırır.

Parametreler:

• tokenName: Tam protocol/token adı (örn. 'Uniswap')
• tokenTicker: Ticker sembolü (örn. 'UNI')

API anahtarı gerekli değildir. Ücretsiz public API'yi kullanır. İstekler 15 saniye sonra timeout olur. Protocol index, her çağrıda /protocols'u hammering yapmamak için proses başına 5 dakika cachelenir.

defillama-search

DeFiLlama'nın protocol index'ini arar ve slug'ları, TVL'leri ve kategorileri ile aday eşleşmeleri döndürür. Ticker belirsiz olduğunda (örn. benzer isimleri olan birden fazla protocol) kullanışlıdır.

Parametreler:

• query: Arama sorgusu — protocol adı, ticker veya slug

📝 Prompts

token-research

Bir kripto para token'ı üzerine kapsamlı araştırma başlatır.

Parametreler:

• tokenName: Kripto para token'ının tam adı
• tokenTicker: Token'ın ticker sembolü (örn. BTC, ETH)

🧠 Nasıl Çalışır

1. Araştırma başladığında, token'ın tüm yönlerini kapsayan yapılandırılmış bir plan oluşturulur
2. Server, bilgi için birden fazla kaynakta aramalar gerçekleştirir
3. Arama sonuçları referans alınabilecek kaynaklar olarak saklanır
4. Araştırma, durum izleme ile farklı bölümlerde ilerler
5. Token'ın tüm yönlerini kapsayan kapsamlı bir rapor oluşturulur

⚠️ Sınırlamalar

• Bazı web siteleri web scraping'i engeller, bu nedenle doğrudan içerik getirme 403 hatalarıyla başarısız olabilir
• Arama sonuçlarına bağlıdır ve bunlar her zaman kapsamlı olmayabilir
• Arama işlemlerine rate limit'ler uygulanabilir

📄 Lisans

Bu proje Apache License 2.0 altında lisanslanmıştır - detaylar için LICENSE dosyasına bakın.