Bitcoin Stratigraphy MCP

npx add-mcp 'https://bitcoin-stratigraphy-dashboard.replit.app/mcp'

Bitcoin Stratigraphy MCP — Geliştirici Dağıtımı

Sürüm: 1.1.0 · MCP kayıt adı: crstrogish/bitcoin-stratigraphy

Bitcoin Stratigraphy MCP motoru için bağımsız, uzaktan öncelikli bir entegrasyon deposu: kayıt meta verileri, OpenAPI sözleşmeleri, bağımlılıksız istemciler ve yerel framework ajan örnekleri. Ücretsiz sanal alan için Replit çalışma alanı, cüzdan, API anahtarı veya model sağlayıcı hesabı gerekmez.

Kapsam ve güvenlik durumu

Bu paket barındırılan motora bağlanır; tam yerleşim sunucusunu çevrimdışı çalıştırdığını iddia etmez veya içermez. İstemci kaynakları, canlı hizmete veya bağımsız olarak işletilen uyumlu bir MCP uç noktasına karşı yerel olarak çalıştırılabilir. Çalışma alanı takma adları, satılmış kimlik bilgileri, özel imzalama anahtarları, operatör durumu veya üst depoya bağımlılık yoktur.

LangChain yürütme desteklenir. LlamaIndex kaynağı korunur, ancak bağımlılık kurulumu ve yürütme geçici olarak kullanılamaz: NLTK bağımlılığı GHSA-8mgp-746c-j5xp tarafından etkilenir. LlamaIndex gereksinimler dosyası kasıtlı olarak hiçbir şey kurmaz. Güvenlik kontrollerini atlamayın veya rozeti desteklenen yürütme iddiası olarak değerlendirmeyin. Güvenli, eksiksiz bir bağımlılık ağacını denetledikten sonra kurulumu geri yükleyin.

Canlı MCP motoruna bağlanın

Yüzey	URL
Akışkan HTTP MCP	https://bitcoin-stratigraphy-dashboard.replit.app/mcp
Geliştirici portalı	https://bitcoin-stratigraphy-dashboard.replit.app/docs
Canlı OpenAPI	https://bitcoin-stratigraphy-dashboard.replit.app/openapi.json

MCP URL'sini herhangi bir Akışkan HTTP istemcisinde kullanın. İstemcinizin URL tabanlı MCP yapılandırmasını desteklediği yerde mcp.json dosyasını içe aktarın; bazı ana bilgisayarlar kendi yapılandırma biçimlerinde açık bir taşıma türü gerektirir. smithery.yaml dosyası uzak kayıt meta verileri için kurallıdır, yerel sunucu başlatma tarifi değildir.

Sunucu 15 kurallı yetenek duyurur. initialize ve tools/list ücretsiz protokol keşif işlemleridir. Tam olarak iki araç yürütmesi ücretsizdir:

Araç	Bağımsız Değişkenler	Amaç
stratigraphy.list	{}	Dizinlenmiş tarihleri/yükseklikleri, sınırları ve mevcut metrikleri keşfedin
proof.list	{}	Desteklenen kanıt işlemlerini ve şema meta verilerini listeleyin

Katalog keşfi ödeme yetkilendirmesi değildir. Diğer kurallı araçlar ücretli erişim gerektirir; satın alma işlemlerini yetkilendirmeden önce canlı şemaları ve ödeme koşullarını sorgulayın.

Ücretsiz sanal alan hızlı başlangıç — cüzdan gerekmez

Node.js 22 veya daha yeni

Bu deponun kökünden, paket kurulumu olmadan:

node examples/free-sandbox.mjs

Bu, MCP'yi müzakere eder, başlatılmış bildirimi gönderir ve ardından yalnızca stratigraphy.list ve proof.list çağırır. İmzalamaz, ödeme yapmaz, kimlik bilgisi eklemez veya LLM isteği yapmaz. Ücretsiz bir çağrı HTTP 402 döndürürse ödeme yapmak yerine başarısız olur.

Kendi uyumlu uç noktanızı kullanmak için:

node examples/free-sandbox.mjs --url http://127.0.0.1:5000/mcp

Bu bir istemci bağlantısıdır, üretim motorunu başlatma komutu değildir.

Python 3.11 veya daha yeni

Paketlenmiş istemci standart kitaplıkla çalışır; framework kurulumu gerekmez:

python -m examples.free_sandbox

Eşdeğer kopyala-yapıştır Python:

from sdk.python.client import BitcoinStratigraphyClient

client = BitcoinStratigraphyClient()
print(client.call_tool("stratigraphy.list", {}))
print(client.call_tool("proof.list", {}))

Kodu depo kökünden çalıştırın, böylece sdk ad alanı içe aktarılabilir. TLS doğrulaması etkin kalır. Kuruluşunuz özel bir CA kullanıyorsa, güvenilir sertifika deposunu yapılandırın; doğrulamayı devre dışı bırakmayın.

L402: 100 çağrılık Macro-Macaroon grupları

Ücretli yetenekler araç kapsamlı kimlik bilgileri kullanır. Bir grup talep etmek için şunları ekleyin:

X-L402-Batch-Size: 100

Örneğin, bu istek bir noter tasdik grubu meydan okuması ister; bir fatura ödemez:

curl --include --request POST \
  'https://bitcoin-stratigraphy-dashboard.replit.app/mcp' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --header 'X-L402-Batch-Size: 100' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"proof.notarize","arguments":{"hash":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}}'

1. HTTP 402'yi, L402 WWW-Authenticate meydan okumasını, fatura tutarını, son kullanma tarihini ve tam araç kapsamını inceleyin.
2. Yalnızca açık harcama limitleri olan güvenilir bir Lightning cüzdanı/istemcisi aracılığıyla ödeme yapın. Yerleşim kanıtının meydan okunan ödeme karmasıyla eşleştiğini doğrulayın.
3. Aynı araç çağrısını grup başlığıyla yeniden deneyin ve:

Authorization: L402 <macaroon>:<preimage>
X-L402-Batch-Size: 100

Kayıtlı noter tasdik fiyatı 250 sats/çağrı × 100 = 25.000 sats'tir. Canlı fatura yetkilidir; kayıt hedef fiyat örnekleri fiyat garantisi değildir. Bir proof.notarize geçişi diğer ücretli araçların kilidini açmaz. Bütçeler, son kullanma, iptal ve devralınan koşullar her kullanımda geçerlidir. Zayıflatma kapsamı devreder veya daraltır; üst bütçeyi sıfırlamaz.

Yerel framework bağdaştırıcıları cüzdan değildir. L402_AUTHORIZATION aracılığıyla ön ödemeli bir kimlik bilgisi veya L402_PROXY_URL aracılığıyla açık harcama limitleri olan güvenilir bir geri döngü Akışkan HTTP cüzdan proxy'si sağlayın. Kimlik bilgilerini veya model sağlayıcı sırlarını kaydetmeyin. Eski tek seferlik SDK ödeme geri çağrıları otomatik Macro-Macaroon gruplama uygulamaları değildir.

LangChain: yerel MCP ve ReAct döngüleri

Daha eski bir MCP 1.x ortamı değil, ayrı bir tüketici Python ortamı kullanın:

python -m pip install -r cookbooks/requirements-langchain.txt
python cookbooks/langchain_agent.py

Varsayılan mod yalnızca araçları keşfeder. Bir LLM ve ücretli noter tasdikine katılmak için sağlayıcı anahtarınızı ve ön ödemeli bir proof.notarize grup kimlik bilgisini sır yöneticiniz aracılığıyla yapılandırın, ardından çalıştırın:

python cookbooks/langchain_agent.py --run

Kopyala-yapıştır yalnızca ücretsiz araç ReAct döngüsü (MCP çağrıları ücretsizdir; model kullanımı model sağlayıcınız tarafından faturalandırılır):

import asyncio
from fastmcp.client import Client
from fastmcp.client.transports import StreamableHttpTransport
from langchain.mcp import MCPAdapter
from langchain.agents import create_agent
from langchain_openai import ChatOpenAI

async def main():
    transport = StreamableHttpTransport(
        url="https://bitcoin-stratigraphy-dashboard.replit.app/mcp"
    )
    client = Client(transport, mode="legacy", timeout=30)
    async with MCPAdapter(client) as adapter:
        tools = await adapter.list_tools()
        free = [
            t.model_copy(update={"name": t.name.replace(".", "_")})
            for t in tools if t.name in {"stratigraphy.list", "proof.list"}
        ]
        if len(free) != 2:
            raise RuntimeError("Expected both free sandbox capabilities")
        agent = create_agent(
            model=ChatOpenAI(model="gpt-4.1-mini", temperature=0),
            tools=free,
            system_prompt="Use only these discovery tools. Report actual results.",
        )
        result = await agent.ainvoke(
            {"messages": [{"role": "user", "content":
                "List indexed stratigraphy bounds and supported proof operations."}]}
        )
        print(result["messages"][-1].content)

asyncio.run(main())

create_agent mevcut ReAct model → araç → gözlem döngüsünü uygular. Alt çizgi takma adları model sağlayıcı adlandırma kurallarını karşılar; sarmalayıcılar orijinal noktalı uzak araç adlarını korur.

LlamaIndex: korunmuş yerel ajan örneği

Bağımlılık güvenlik duraklaması kaldırılana kadar yalnızca kaynak. Aşağıdaki kopyala-yapıştır örneği, gelecekteki denetlenmiş bir ortam için desteklenen API şeklini belgeler; şimdi güvenlik açığı olan bağımlılıkları kurma talimatı değildir. Tam ücretli noter tasdik örneği cookbooks/llamaindex_agent.py dosyasındadır.

import asyncio
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import ReActAgent
from llama_index.llms.openai import OpenAI

async def main():
    client = BasicMCPClient(
        "https://bitcoin-stratigraphy-dashboard.replit.app/mcp", timeout=30
    )
    try:
        tools = await McpToolSpec(client=client).to_tool_list_async()
        free = [t for t in tools if t.metadata.name in
                {"stratigraphy.list", "proof.list"}]
        if len(free) != 2:
            raise RuntimeError("Expected both free sandbox capabilities")
        for tool in free:
            tool.metadata.name = tool.metadata.name.replace(".", "_")
        agent = ReActAgent(
            tools=free,
            llm=OpenAI(model="gpt-4.1-mini", temperature=0),
            system_prompt="Use only the discovery tools. Report actual results.",
            timeout=90,
        )
        response = await agent.run(
            user_msg="List indexed stratigraphy bounds and supported proof operations."
        )
        print(str(response))
    finally:
        await client.http_client.aclose()

asyncio.run(main())

Model kimlik bilgileri ve ücretleri MCP ödemelerinden ayrıdır.

TypeScript SDK

sdk/typescript hem REST istemcisini hem de MCP istemci kaynaklarını, bağımsız derleyici yapılandırmalarını, yerel testleri ve kendi paket bildirimini içerir. SDK sürüm 0.1.0, kayıt sürümü 1.1.0'dan bağımsızdır.

cd sdk/typescript
npm install
npm test
npm run build

Kök paket bildirimi kurallı MCP kayıt kimliğini ve sürüm sürümünü korur, ancak monorepo komut dosyalarını/bağımlılıklarını taşınabilir dağıtım komutlarıyla değiştirir. Özel çalışma alanı orkestrasyon bildirimi değildir.

Depo içeriği ve dışa aktarma kontrolleri

README.md                 Distribution and operational guide
package.json              Portable MCP metadata and sandbox/test commands
smithery.yaml             Canonical remote registration manifest
mcp.json                  Remote MCP client configuration
openapi.yaml              Canonical self-contained REST/OpenAPI contract
openapi.json              JSON rendering of the same canonical contract
LICENSE                   MIT license
cookbooks/                Native framework sources, requirements, and offline tests
sdk/typescript/           TypeScript REST/MCP clients and standalone package
sdk/python/               Python REST/MCP clients and offline tests
examples/                 Wallet-free Node/Python sandbox entrypoints
test/                     Node sandbox transport and safety tests
scripts/verify-export.mjs  Portable structure, import, and reference checks

npm run verify
npm test
python -m unittest discover -s cookbooks -p 'test_*.py'
python -m unittest discover -s sdk/python -p 'test_*.py'

verify göreli kaynak içe aktarmalarını ve Markdown dosya referanslarını, komut dosyası ve SDK paket yollarını, JSON sözdizimini ve çalışma alanı bağımlılık takma adlarının yokluğunu kontrol eder. Ek sözdizimi kontrolleri olarak Python'u derleyin ve SDK'yı oluşturun. Açıkça bir sanal alan veya ajan giriş noktası çalıştırmadığınız sürece testler çevrimdışıdır.

Operasyonel sınırlar

• Dizinlenmiş stratigrafi yükseklikleri belgelenmiş bir günlük veri endeksidir, canlı Bitcoin ucu veya yerel blok başına kaynak kanıtı değildir.
• OTS takvim kabulü Bitcoin onayı değildir. Ayrılmış makbuzu saklayın ve eşleşen özetini ve Bitcoin tasdikini ayrı ayrı doğrulayın.
• Temellendirme imzaları, ZK kanıtları ve OTS makbuzları farklı gerçekler kurar; birini diğeri olarak tanımlamayın.
• SDK'lar ödeme hatalarında durur. Ücretli çağrıları körü körüne yeniden denemeyin veya ödeme kanıtlarını günlüğe kaydetmeyin. Kimlik bilgilerini bir sır yöneticisinde saklayın ve bir ajanı etkinleştirmeden önce harcama ve araç kapsamını gözden geçirin.
• OpenAPI sözleşmesi REST'i kapsar; canlı MCP tools/list yürütülebilir MCP şemalarını tanımlar. OpenAPI şema sürümü ve SDK sürümünün kayıt sürümüyle eşleşmesi gerekmez.
• İsteğe bağlı framework bağımlılıklarını kurmadan veya güncellemeden önce denetleyin. Yerel cüzdan, imzalama veya yerleşim kimlik bilgileri gönderilmez.

Lisans

MIT. LICENSE dosyasına bakın. Framework'ler ve isteğe bağlı bağımlılıklar kendi lisanslarını ve koşullarını korur.

🤖 CrewAI Entegrasyonu

Bitcoin Stratigraphy Veri Motoru, CrewAI'nin MCPServerAdapter özelliğini yerel olarak destekler. Bu parçayı iş akışınıza ekleyin ve ajanlarınızı anında termodinamik araçlar ve OpenTimestamps durum sabitleme ile donatın:

pip install crewai-tools[mcp]

Tam ajan yürütme komut dosyası için crewai_cookbook.py kontrol edin.