Finance & Fintech TypeScript ★ 86

alchemyplatform/alchemy-mcp-server

Alchemy'nin blockchain API'lerini kullanarak AI ajanlarının etkileşim kurmasını sağlayın.

Claude Desktop config.json'a ekle

{
  "mcpServers": {
    "alchemyplatform-alchemy-mcp-server": {
      "command": "node",
      "args": [
        "~/.mcp/alchemy-mcp-server/index.js"
      ]
    }
  }
}

Alchemy MCP Sunucusu

Yapay zeka ajanlarının Alchemy'nin blockchain API'lerini yapılandırılmış bir şekilde kullanmasını sağlayan bir Model Context Protocol (MCP) sunucusu. Bu, ajanların herhangi bir kod yazmadan doğrudan blockchain verilerini sorgulamasına olanak tanır.

Uzak MCP Sunucusu (Önerilen)

En hızlı başlama yöntemi, https://mcp.alchemy.com/mcp adresindeki barındırılan uzak sunucuya bağlanmaktır. OAuth ile kimlik doğrulama yapılır — istendiğinde Alchemy hesabınızla oturum açın. API anahtarı veya yerel kurulum gerekmez.

Tam dokümantasyon: alchemy.com/docs/alchemy-mcp-server

Not: mcp.alchemy.com adresindeki barındırılan sunucu ve bu açık kaynaklı depo ayrı ayrı yönetilmektedir ve senkronize olmayabilir.

İstemci Kurulum
Claude Code claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp
Codex codex mcp add alchemy --url https://mcp.alchemy.com/mcp
Cursor ~/.cursor/mcp.json veya .cursor/mcp.json dosyasına ekleyin — aşağıdaki JSON yapılandırmasına bakın
Windsurf ~/.codeium/windsurf/mcp_config.json dosyasına ekleyin — aşağıdaki JSON yapılandırmasına bakın
VS Code Copilot .vscode/mcp.json dosyasına ekleyin — aşağıdaki JSON yapılandırmasına bakın
Claude Desktop claude_desktop_config.json dosyasına ekleyin — aşağıdaki JSON yapılandırmasına bakın
Cline VS Code komut paletinden Cline: MCP Servers açın — aşağıdaki JSON yapılandırmasına bakın
Cursor / Windsurf / Claude Desktop / Cline için JSON yapılandırması
{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}
VS Code Copilot için JSON yapılandırması
{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Diğer MCP uyumlu istemciler için https://mcp.alchemy.com/mcp adresine Streamable HTTP transportu kullanarak yönlendirin.

Yerel STDIO Sunucusu

Bu MCP sunucusu yapay zeka ajanları ile Alchemy'nin blockchain API'leri arasında bir köprü oluşturarak, ajanların şu işlemleri yapmasını sağlar:

  • Token fiyatları ve fiyat geçmişini sorgulama (esnek zaman dilimi sorguları dahil)
  • NFT sahiplik bilgisi ve sözleşme verilerini alma
  • Birden fazla ağ üzerinde işlem geçmişini görüntüleme
  • Birden fazla blockchain ağında token bakiyelerini kontrol etme
  • Filtreleme ile ayrıntılı varlık transferlerini alma
  • Smart Contract Hesapları aracılığıyla işlem gönderme (yapılandırılmış cüzdan ajanı sunucusu gereklidir)
  • DEX protokolleri aracılığıyla token takasları gerçekleştirme (yapılandırılmış cüzdan ajanı sunucusu gereklidir)
  • Ve daha fazlası!

Hızlı Kurulum

MCP sunucusunu hızlıca kurmak için, MCP yapılandırma dosyanızda (genellikle Claude Desktop veya Cursor ayarlarında) aşağıdaki yapılandırmayı kullanın:

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Bu yapılandırma, depoyu manuel olarak klonlamadan sunucuyu kullanmanıza olanak tanır.

Ortam Değişkenleri

MCP sunucusu aşağıdaki ortam değişkenini gerektirir:

  • ALCHEMY_API_KEY - Alchemy API anahtarınız (tüm blockchain veri sorgulamaları için zorunludur)

İşlem gönderme ve takas işlevselliği için, ayrıca şunları yapılandırmanız gerekir:

  • AGENT_WALLET_SERVER - Smart Contract Account işlemlerini yöneten yapılandırılmış bir cüzdan ajanı sunucusunun URL'si

⚠️ Önemli: sendTransaction ve swap yöntemleri, düzgün şekilde yapılandırılmış bir cüzdan ajanı sunucusu olmadan çalışmayacaktır. Bu yöntemler, işlemleri imzalamak ve yayınlamak için harici cüzdan altyapısı gerektirir.

Mevcut Yöntemler

Yapay zeka ajanınıza aşağıdaki yöntemleri kullanmasını söyleyebilirsiniz:

Token Fiyatı Yöntemleri

  1. fetchTokenPriceBySymbol

    • Sembol bazında tokenler için güncel fiyat verilerini alır
    • Örnek: "ETH ve BTC'nin güncel fiyatı nedir?"
  2. fetchTokenPriceByAddress

    • Sözleşme adresi bazında tokenler için güncel fiyat verilerini alır
    • Örnek: "0x1234...5678 adresindeki tokenin Ethereum mainnet'teki fiyatı nedir?"
  3. fetchTokenPriceHistoryBySymbol

    • Belirli tarih aralıkları ile tokenler için geçmiş fiyat verilerini alır
    • Örnek: "1 Ocak'tan 1 Şubat 2023'e kadar günlük aralıklarla BTC fiyat geçmişini göster"
  4. fetchTokenPriceHistoryByTimeFrame

    • Esnek zaman dilimleri veya doğal dil kullanarak geçmiş fiyat verilerini alır
    • Örnek: "Son bir haftanın ETH fiyatını göster" veya "BTC fiyatını son 30 günden getir"

Çok Ağlı Token Yöntemleri

  1. fetchTokensOwnedByMultichainAddresses
    • Birden fazla ağ üzerinde adresler için token bakiyelerini alır
    • Örnek: "0xabc...123 adresi Ethereum ve Base üzerinde hangi tokenları tutuyor?"

İşlem Geçmişi Yöntemleri

  1. fetchAddressTransactionHistory

    • Birden fazla ağ üzerinde adresler için işlem geçmişini alır
    • Örnek: "0xdef...456 cüzdanının Ethereum üzerindeki son işlemlerini göster"
  2. fetchTransfers

    • Gelişmiş filtreleme seçenekleri ile ayrıntılı varlık transferi verilerini alır
    • Örnek: "0xghi...789'dan veya 0xghi...789'a tüm ERC-20 transferlerini göster"

NFT Yöntemleri

  1. fetchNftsOwnedByMultichainAddresses

    • Spam filtrelemesi ile adresler tarafından sahip olunan tüm NFT'leri alır
    • Örnek: "0xjkl...012 adresi hangi NFT'lere sahiptir?"
  2. fetchNftContractDataByMultichainAddress

    • Adresler için NFT sözleşme verilerini alır
    • Örnek: "0xmno...345 hangi NFT koleksiyonlarından token'lara sahiptir?"

İşlem Yöntemleri

  1. sendTransaction
    • Smart Contract Hesapları aracılığıyla işlem gönderir
    • ⚠️ Önemli: AGENT_WALLET_SERVER ortam değişkeni ile yapılandırılmış bir cüzdan ajanı sunucusu gerektirir
    • Örnek: "0xpqr...678'e 0.1 ETH gönder"

Takas Yöntemleri

  1. swap
    • DEX protokolleri aracılığıyla token takasları gerçekleştirir (Uniswap)
    • ⚠️ Önemli: AGENT_WALLET_SERVER ortam değişkeni ile yapılandırılmış bir cüzdan ajanı sunucusu gerektirir
    • Örnek: "100 USDC'yi ETH için takas et"

Yerel Geliştirme ve Açık Kaynak Katkıları

Kurulum

  1. Depoyu klonlayın
git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp
  1. Bağımlılıkları yükleyin
pnpm install

Geliştirme

pnpm watch

Üretim için Derleme

pnpm build

Hata Ayıklama için MCP Inspector'ı Kullanma

MCP Inspector, yöntemlerinizi test etmek için görsel bir arayüz sağlayarak MCP sunucunuzdaki hataları ayıklamanıza yardımcı olur:

pnpm inspector

Bu, tarayıcınızda erişebileceğiniz MCP Inspector'ı başlatacaktır. Size aşağıdakileri yapmanıza izin verir:

  • Tüm mevcut yöntemleri görme
  • Yöntemleri farklı parametrelerle test etme
  • Yanıt verilerini görüntüleme
  • MCP sunucunuzdaki sorunları ayıklama

Katkıda Bulunma

Pull request'ler memnuniyetle karşılanır. Büyük değişiklikler için lütfen önce bir issue açarak neyi değiştirmek istediğinizi tartışın.

Lisans

Bu MCP sunucusu MIT Lisansı altında lisanslanmıştır. Bu, MIT Lisansının hüküm ve koşullarına tabi olarak yazılımı serbestçe kullanma, değiştirme ve dağıtma hakkı verdiği anlamına gelir.

Örnek İstemler

Yapay zeka ajanınızla kullanabileceğiniz bazı örnek istemler:

Bitcoin ve Ethereum'un güncel fiyatları nedir?

0x1234...5678 cüzdanının Ethereum üzerinde sahip olduğu NFT'leri göster.

0xabcd...6789 cüzdanı Ethereum ve Base üzerinde hangi tokenları tutuyor?

0x9876...5432 için işlem geçmişini al.

1 Ocak'tan bugüne kadar günlük aralıklarla Ethereum'un fiyat geçmişini göster.

Son bir haftanın saatlik aralıklarla Bitcoin fiyat verilerini al.

Son ayın ETH fiyat performansını göster.

Son 100 blokta 0x1234...5678 adresine hangi ERC-20 transferleri gerçekleşti?

API Başvurusu

Alchemy'nin API'leri hakkında daha fazla bilgi için bkz:

Benzer MCP sunucuları

Daha fazla: Finance & Fintech →