₿itcoin & Lightning Network MCP Server

Dokumentasyon | Claude ile Dene | Goose ile Dene

Genel Bakış

AI modellerinin Bitcoin ve Lightning Network ile etkileşime girmesini sağlayan bir Model Context Protocol (MCP) sunucusu. Anahtarlar üretmek, adresleri doğrulamak, işlemleri çözmek, blockchain sorgulamak ve daha fazlasını yapabilirler.

🎮 Demo

Claude Demo Video	Goose Demo Video

💼 İçindekiler

₿itcoin & Lightning Network MCP Server

🔧 Özellikler

Anahtar Üretimi: Yeni Bitcoin anahtar çiftleri oluşturun — adres, açık anahtar ve özel anahtar (WIF) dahil.
Adres Doğrulaması: Bir Bitcoin adresinin doğruluğunu doğrulayın.
İşlem Çözümü: Ham bir Bitcoin işlemini ayrıştırın ve ayrıntılarını insan tarafından okunabilir bir biçimde görüntüleyin.
Blockchain Sorguları:
- Son Blok: En son blok hakkında ayrıntıları alın (hash, yükseklik, zaman damgası, işlem sayısı, vb.).
- İşlem Ayrıntıları: TXID kullanarak bir işlem hakkında ayrıntılı bilgi alın.
Lightning Network:
- Fatura Çözümü: BOLT11 Lightning faturasını ayrıştırın ve insan tarafından okunabilir bilgiler görüntüleyin.
- Ödeme: LNBits cüzdanınızdan doğrudan Lightning faturasına ödeme yapın.

🔑 Claude Desktop Entegrasyonu

Bitcoin MCP sunucusunu Claude Desktop (Anthropic'in Claude için masaüstü uygulaması) ile kullanmak için aşağıdaki adımları izleyin:

Claude Desktop'ı İndirin ve Yükleyin: Resmi Claude Desktop indirme sayfasını ziyaret edin ve işletim sisteminiz için uygulamayı alın (macOS veya Windows) (Installing Claude for Desktop | Anthropic Help Center). Uygulamayı yükleyin ve en son sürümü kullandığınızdan emin olun (uygulama menüsünden güncellemeleri kontrol edebilirsiniz).
Claude Desktop'ı Bitcoin MCP Sunucusunu Kullanacak Şekilde Yapılandırın: Claude Desktop yapılandırma dosyasını açın (Claude Desktop'ta ayarları düzenlerken oluşturulur):
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
  Bu JSON yapılandırmasında "mcpServers" bölümü altına Bitcoin MCP sunucusu için bir giriş ekleyin. Örneğin:
```
{
  "mcpServers": {
    "bitcoin-mcp": {
      "command": "npx",
      "args": ["-y", "bitcoin-mcp@latest"]
    }
  }
}
```
Yukarıdaki kod parçacığında "bitcoin-mcp" sunucunun bir tanımlayıcısıdır (istediğiniz şekilde adlandırabileceğiniz). command npx komutunu çalıştırmak için ayarlanmış ve args Bitcoin MCP sunucusu betiğinin yolunu veya sunucuyu çalıştırma komutunu işaret eder.
Claude Desktop'ı Yeniden Başlatın: claude_desktop_config.json dosyasını kaydedin ve ardından Claude Desktop'ı kapatıp yeniden açın. Sonraki açılışında Claude, yapılandırıldığı şekilde Bitcoin MCP sunucusunu otomatik olarak başlatacaktır. Claude Desktop çalışıyorsa, değişikliklerin geçerli olması için onu yeniden başlatmanız gerekir.

Claude Desktop Entegrasyonunu Test Etme

Claude Desktop yeniden başlatıldıktan sonra, Bitcoin MCP sunucusunun düzgün çalışıp çalışmadığını test edebilirsiniz:

Claude'a Bitcoin ile ilgili örnek bir soru sorun. Örneğin, şunu sorabilirsiniz: "Bitcoin ağında son blok nedir?" Entegrasyon başarılı ise, Claude'un yanıtı MCP sunucusu tarafından alınan son bloğu içermelidir; "Bilmiyorum" veya genel bir cevap yerine. Ayrıca diğer sorguları da deneyebilirsiniz: "abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 TXID'li işlem hakkında bilgi ver." Claude, MCP sunucusunun araçlarını kullanarak verileri almalı ve sorgunuzu cevaplamalıdır.
Yanıtı Doğrulayın: Claude hatasız ayrıntılı bir yanıt döndürmelidir (örneğin Bitcoin ağındaki son blok). Hata iletisi veya yararlı bir yanıt almazsanız, MCP sunucusu düzgün bağlanmamış olabilir.
Claude'un günlüklerini kontrol edin (gerekirse): Claude Desktop, MCP entegrasyonlarında hata ayıklamaya yardımcı olabilecek günlük dosyaları sağlar. Aracı yanıt vermiyorsa, şu yerlerdeki günlük dosyalarını kontrol edin:
- macOS: ~/Library/Logs/Claude/
- Windows: %APPDATA%\Claude\logs\
  Genel MCP bağlantı mesajleri için mcp.log dosyasını ve MCP sunucusunun çıktısı/hataları için mcp-server-bitcoin-mcp.log adlı dosyayı (veya kullandığınız herhangi bir ad) arayın. Bu günlükler sunucunun başlatılıp başlatılmadığını veya herhangi bir hata (yanlış yol veya sunucudaki istisna gibi) olup olmadığını gösterecektir. Hata görürseniz, yapılandırmayı veya ortamı düzeltin, ardından Claude Desktop'ı yeniden başlatın ve tekrar test edin.

🦆 Goose Entegrasyonu

Goose, Model Context Protocol aracılığıyla uzantıları destekleyen Block tarafından sağlanan açık kaynaklı bir AI agent framework'tür. Bitcoin MCP sunucusunu, Goose'un Bitcoin blockchain ile etkileşime girmesini sağlayan bir Goose uzantısı olarak entegre edebilirsiniz. Goose, MCP sunucuları için iki entegrasyon modunu destekler: sunucuyu yerel bir işlem olarak çalıştırma (STDIO) veya bunu Sunucu Tarafından Gönderilen Olaylar (SSE) aracılığıyla uzak bir hizmet olarak bağlama. Her iki yöntem için de talimatlar aşağıda verilmiştir:

STDIO Kullanma (Yerel Uzantı)

Bu yöntem Bitcoin MCP sunucusunu Goose'un bir alt işlemi olarak yerel olarak çalıştırır ve standart giriş/çıkış aracılığıyla iletişim kurar.

Goose'da yeni bir uzantı ekleyin: Goose'un yapılandırma arayüzünü açın. Bunu komut satırında goose configure komutunu çalıştırarak veya Goose Desktop uygulamasında Ayarlar > Uzantılar'a giderek yapabilirsiniz. Menüden "Uzantı Ekle"yi seçin. (Using Extensions | goose)
Uzantı türünü seçin – Komut Satırı Uzantısı: Uzantı türü istendiğinde, Komut Satırı Uzantısı'nı seçin (CLI menüsünde veya UI'da), böylece Goose yerel bir komut başlatması gerektiğini bilir (Using Extensions | goose) (yerleşik veya uzak uzantıya karşı).
Uzantı ayrıntılarını girin: Bitcoin MCP sunucusu için bir ad ve komut sağlayın:
- Ad: "bitcoin" veya başka bir tanımlayıcı olarak adlandırabilirsiniz (uzantıyı böyle çağıracaksınız).
- Komut: MCP sunucusunu çalıştırmak için nasıl yapılacağını belirtin. Örneğin, Python betiğiniz varsa, bunu çalıştırma komutunu girin. CLI yapılandırıcısında, "Hangi komut çalıştırılmalı?" sorusu sorabilir — şunu girersiniz:
```
npx -y bitcoin-mcp@latest
```
  Bu Goose'a Bitcoin MCP sunucusunu başlaması için söyler (GitHub - AbdelStark/bitcoin-mcp: Bitcoin MCP Server). (Sunucu betiğinin doğru yolunu veya sunucuyu çalıştırma komutunu kullandığınızdan emin olun, tıpkı Claude yapılandırmasında olduğu gibi.)
- Genellikle betik yolunun ötesine hiçbir argument eklemeniz gerekmez (sunucunuz özel bayraklar gerektirmediği sürece). Yukarıdaki komut, Goose'un bir komut satırı uzantısı için beklediği varsayılan STDIO taşımasını kullanır. (Goose config dosyasında bu, cmd: "npx" ve args: ["-y", "bitcoin-mcp@latest"] içeren bir giriş olarak karşılık gelir; type: stdio standart I/O modunu belirtir (Using Extensions | goose).)
Sonlandır ve etkinleştir: Uzantı eklemeyi tamamlayın. Goose bu yeni uzantıyı yapılandırmasına ekleyecektir (genellikle ~/.config/goose/config.yaml). Uzantının etkinleştirildiğinden emin olun (CLI sihirbazını kullanıyorsanız eklendikten sonra varsayılan olarak etkinleştirilmiş olmalıdır; Goose Desktop uygulamasında, Uzantılar listesini kontrol edebilir ve zaten açık değilse etkinleştirebilirsiniz (Using Extensions | goose) (Using Extensions | goose)).
Yeni uzantı ile bir Goose oturumu başlatın: Artık uzantıyı Goose'da kullanabilirsiniz. Goose'u CLI aracılığıyla çalıştırıyorsanız, şu komutu çalıştırarak uzantıyı içeren bir oturum başlatın:
```
goose session --with-extension "bitcoin"
```

uzantıya verdiğiniz adla "bitcoin" yerine koyun (Using Extensions | goose). (Bu oturumun uzantıyı yüklemesini sağlar. Alternatif olarak, uzantı küresel olarak etkinleştirilirse, Goose Desktop veya CLI otomatik olarak tüm oturumlarda kullanılabilir hale gelir.)

SSE Kullanma (Uzak Uzantı)

Bu yöntem Goose'u zaten çalışan bir MCP sunucusuna HTTP SSE akışı üzerinden bağlar. Bunu Bitcoin MCP sunucusunu bağımsız bir hizmet olarak (muhtemelen başka bir makinede veya Goose'tan bağımsız olarak) çalıştırmak istiyorsanız kullanın.

MCP sunucusunu bağımsız bir hizmet olarak başlatın: Bitcoin MCP sunucusunu bağlantılar için dinleyecek şekilde çalıştırın. Pratikte bu, sunucunun MCP için HTTP endpoint'inin hizmet vermesini sağlayacak şekilde başlatılması anlamına gelir. Örneğin, sunucuyu belirli bir komut veya seçenekle bir port üzerinde dinlemek için çalıştırabilirsiniz (MCP kütüphanesinin yerleşik web sunucusu özelliklerini kullanarak veya bir web framework'ü altında çalıştırarak). Sunucunun bilinen bir URL'de erişilebilir olduğundan emin olun (örneğin http://localhost:9000) ve MCP protokolünü SSE üzerinden destekleyin.
Goose'da yeni bir uzantı ekleyin (Uzak): Daha önce olduğu gibi, goose configure komutunu çalıştırın veya Goose UI'sında Uzantı Ekle'yi kullanın (Using Extensions | goose). Bu sefer, uzantı türü istendiğinde Uzak Uzantı'nı seçin (Using Extensions | goose). Bu Goose'a SSE aracılığıyla harici bir sunucuya bağlanacağını söyler.
Uzak uzantı ayrıntılarını girin: Uzantıya bir ad verin (örneğin "bitcoin") ve sunucunun URL'sini sağlayın. URL için, MCP sunucusunun çalıştığı temel adresini girin. Örneğin, sunucunuz yerel makinenizde port 9000'de dinliyorsa, http://localhost:9000 girebilirsiniz. Goose, MCP sunucusunun SSE endpoint'sine o adresle bağlanmaya çalışacaktır. (Goose standart MCP SSE yolunu kullanır; kural gereği sunucudaki /mcp/sse yolu altında yer alır; genellikle sadece ana bilgisayar ve port sağlamanız yeterlidir; Goose'un geri kalanını yönetir.)
Uzantıyı etkinleştirin: Uzak uzantıyı ekledikten sonra, Goose'un ayarlarında etkinleştirildiğinden emin olun (STDIO durumunda olduğu gibi). Aynı araçlara sahip STDIO veya SSE uzantısının (aynı adla) sadece biri etkinleştirilmelidir — aynı sunucunun yerel ve uzak sürümünü yanlışlıkla etkinleştirirseniz, karışıklığı önlemek için birini devre dışı bırakmak isteyebilirsiniz.

Goose'da Bitcoin MCP uzantısını kullanma: Uzantı kurulduktan (yukarıdaki yöntemlerden biriyle) ve etkinleştirildikten sonra, Goose ile etkileşime girebilir ve Bitcoin verilerini ona sorgu yapabilirsiniz. Yeni bir Goose sohbeti veya oturumunda, normalde olduğu gibi sorular sorun. Goose, isteğinizi yerine getirmek için Bitcoin MCP araçlarını ne zaman kullanacağını algılayacaktır. Örneğin:

"Bitcoin'in son bloğu nedir?"
"abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890 TXID'li işlem hakkında bilgi ver."

Bu soruları sorduğunuzda, Goose MCP sunucusunun araçlarını çağıracak ve cevabı döndürecektir (örneğin, en son Bitcoin blok bilgileri). Goose'un MCP sunucusu aracılığıyla Bitcoin blockchain'den alınan güncel bilgilerle yanıt vermesini görmelisiniz.

Eğer Goose uzantıyı kullanmıyor gibi görünüyorsa (örneğin, bilgiyi bulamadığını söylüyorsa), uzantının etkinleştirildiğinden emin olun ve sunucunun çalıştığından emin olun (SSE modu için uzak). Uzantıyı çağırmaya çalışıp çalışmadığını görmek için Goose'un CLI'sini ayrıntılı günlüğe kaydedilmiş olarak çalıştırabilirsiniz. Genel olarak doğru yapılandırılmışsa, Goose otomatik olarak MCP sunucusunun yeteneklerini bulacak ve ilgili olduğunda kullanacaktır.

Ek Kaynaklar: Goose uzantıları ve MCP hakkında daha fazla bilgi için resmi Goose belgelerine bakın (Using Extensions | goose). Belgeler yerleşik ve topluluk uzantılarının bir listesini içerir ve MCP sunucularının Goose'a nasıl entegre olduğunu açıklar. Daha fazla uzantı keşfetmek veya kendi uzantınızı geliştirmek istiyorsanız, Goose belgeleri ve Model Context Protocol belgelerinde mevcut MCP sunucularından oluşan bir dizin ve ek yapılandırma ipuçlarını bulabilirsiniz.

📦 Geliştirme Kurulumu

Development Setup kılavuzunda kurulum talimatlarını bulabilirsiniz.

Lightning Network Yapılandırması (İsteğe Bağlı)

Lightning Network özelliklerini kullanmak için LNBits bağlantı ayrıntılarını yapılandırmanız gerekecektir. Bunlar isteğe bağlıdır ve yalnızca Lightning Network araçlarını kullanmayı planlıyorsanız gereklidir.

{
  "lnbitsUrl": "https://demo.lnbits.com",  
  "lnbitsAdminKey": "your_admin_key",      // Ödeme yapmak için gereklidir
  "lnbitsReadKey": "your_read_key"         // Cüzdan bilgileri için gereklidir
}

Bu değerleri şu şekilde elde edebilirsiniz:

LNBits üzerinde bir hesap oluşturun
Yeni bir cüzdan oluşturun
API bilgilerine giderek API anahtarlarınızı bulun

📦 Kullanılabilir Araçlar

Kullanılabilir araçları API Reference kılavuzunda bulabilirsiniz.

🚨 Hata İşleme

Sunucu, Bitcoin işlemlerini ve blockchain sorgularını işlemek için özel hata türleri kullanır. Ayrıntılı hata mesajları Pino kullanılarak günlüğe kaydedilir ve hata ayıklamayı kolaylaştırmak için istemci yanıtlarına dahil edilir.

🤝 Katkı Sağlama

Katkı ve özellik istekleri memnuniyetle karşılanır! GitHub'da pull request göndermekten veya sorun açmaktan çekinmeyin.

📝 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.

AbdelStark/bitcoin-mcp

Bu MCP sunucusu hakkında