Bitcoin Stratigraphy MCP

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

Bitcoin Stratigraphy MCP — Distribusi Pengembang

Rilis: 1.1.0 · Nama registri MCP: crstrogish/bitcoin-stratigraphy

Repositori integrasi mandiri yang berfokus pada remote untuk mesin Bitcoin Stratigraphy MCP: metadata registri, kontrak OpenAPI, klien tanpa dependensi, dan contoh agen framework native. Tidak diperlukan workspace Replit, dompet, kunci API, atau akun penyedia model untuk sandbox gratis.

Ruang lingkup dan status keamanan

Paket ini terhubung ke mesin yang dihosting; paket ini tidak berisi atau mengklaim menjalankan server penyelesaian lengkap secara offline. Sumber klien dapat dijalankan secara lokal terhadap layanan langsung atau endpoint MCP kompatibel yang dioperasikan secara independen. Tidak ada alias workspace, kredensial yang dijual, kunci penandatanganan pribadi, status operator, atau ketergantungan pada repositori induk.

Eksekusi LangChain didukung. Sumber LlamaIndex dipertahankan, tetapi instalasi dependensi dan eksekusi untuk sementara tidak tersedia: dependensi NLTK-nya terpengaruh oleh GHSA-8mgp-746c-j5xp. File persyaratan LlamaIndex sengaja tidak menginstal apa pun. Jangan melewati pemeriksaan keamanan atau memperlakukan lencana sebagai klaim eksekusi yang didukung. Pulihkan instalasi hanya setelah mengaudit pohon dependensi yang aman dan lengkap.

Terhubung ke mesin MCP langsung

Permukaan	URL
MCP HTTP Streamable	https://bitcoin-stratigraphy-dashboard.replit.app/mcp
Portal pengembang	https://bitcoin-stratigraphy-dashboard.replit.app/docs
OpenAPI langsung	https://bitcoin-stratigraphy-dashboard.replit.app/openapi.json

Gunakan URL MCP di klien HTTP Streamable mana pun. Impor mcp.json jika klien Anda mendukung konfigurasi MCP berbasis URL; beberapa host memerlukan jenis transportasi eksplisit dalam format konfigurasi mereka sendiri. smithery.yaml adalah metadata registrasi jarak jauh yang kanonik, bukan resep peluncuran server lokal.

Server mengiklankan 15 kemampuan kanonik. initialize dan tools/list adalah operasi penemuan protokol gratis. Tepat dua eksekusi alat gratis:

Alat	Argumen	Tujuan
stratigraphy.list	{}	Temukan tanggal/ketinggian terindeks, batas, dan metrik yang tersedia
proof.list	{}	Daftarkan operasi bukti yang didukung dan metadata skema

Penemuan katalog bukan otorisasi pembayaran. Alat kanonik lainnya memerlukan akses berbayar; kueri skema langsung dan ketentuan pembayaran sebelum mengotorisasi pembelian.

Panduan memulai sandbox gratis — tanpa dompet

Node.js 22 atau lebih baru

Dari root repositori ini, tanpa instalasi paket:

node examples/free-sandbox.mjs

Ini menegosiasikan MCP, mengirim notifikasi inisialisasi, lalu hanya memanggil stratigraphy.list dan proof.list. Ini tidak menandatangani, membayar, melampirkan kredensial, atau membuat permintaan LLM. Ini gagal daripada membayar jika panggilan gratis mengembalikan HTTP 402.

Untuk menggunakan endpoint kompatibel Anda sendiri:

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

Ini adalah koneksi klien, bukan perintah untuk memulai mesin produksi.

Python 3.11 atau lebih baru

Klien yang disertakan berfungsi dengan pustaka standar; tidak diperlukan instalasi framework:

python -m examples.free_sandbox

Python salin-tempel yang setara:

from sdk.python.client import BitcoinStratigraphyClient

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

Jalankan kode dari root repositori agar namespace sdk dapat diimpor. Verifikasi TLS tetap diaktifkan. Jika organisasi Anda menggunakan CA pribadi, konfigurasikan penyimpanan sertifikat tepercaya; jangan nonaktifkan verifikasi.

L402: Batch Macro-Macaroon 100 panggilan

Kemampuan berbayar menggunakan kredensial yang dicakup alat. Untuk meminta batch, sertakan:

X-L402-Batch-Size: 100

Misalnya, permintaan ini meminta tantangan batch notarisasi; ini tidak membayar faktur:

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. Periksa HTTP 402, tantangan L402 WWW-Authenticate, jumlah faktur, kedaluwarsa, dan cakupan alat yang tepat.
2. Bayar hanya melalui dompet/klien Lightning tepercaya dengan batas pengeluaran eksplisit. Verifikasi bukti penyelesaian cocok dengan hash pembayaran yang ditantang.
3. Coba lagi panggilan alat yang sama dengan header batch dan:

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

Kutipan notarisasi terdaftar adalah 250 sats/panggilan × 100 = 25.000 sats. Faktur langsung bersifat otoritatif; contoh harga target registri bukan jaminan harga. Pass proof.notarize tidak membuka kunci alat berbayar lainnya. Anggaran, kedaluwarsa, pencabutan, dan caveat yang diwariskan tetap berlaku pada setiap penggunaan. Attenuasi mendelegasikan atau mempersempit cakupan; ini tidak mengatur ulang anggaran induk.

Adaptor framework native bukan dompet. Berikan kredensial prabayar melalui L402_AUTHORIZATION, atau proksi dompet HTTP Streamable loopback tepercaya melalui L402_PROXY_URL dengan batas pengeluaran eksplisit. Jangan simpan kredensial atau rahasia penyedia model. Callback pembayaran SDK satu kali yang lebih lama bukan implementasi batching Macro-Macaroon otomatis.

LangChain: loop MCP native dan ReAct

Gunakan lingkungan Python konsumen terpisah, bukan lingkungan MCP 1.x yang lebih lama:

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

Mode default hanya menemukan alat. Untuk memilih LLM dan notarisasi berbayar, konfigurasikan kunci penyedia Anda dan kredensial batch proof.notarize prabayar melalui manajer rahasia Anda, lalu jalankan:

python cookbooks/langchain_agent.py --run

Loop ReAct hanya alat gratis salin-tempel (panggilan MCP gratis; penggunaan model ditagih oleh penyedia model Anda):

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 mengimplementasikan loop model → alat → observasi ReAct saat ini. Alias garis bawah memenuhi aturan penamaan penyedia model; pembungkus mempertahankan nama alat jarak jauh bertitik asli.

LlamaIndex: contoh agen native yang dipertahankan

Hanya sumber sampai penahanan keamanan dependensi dicabut. Contoh salin-tempel berikut mendokumentasikan bentuk API yang didukung untuk lingkungan teraudit di masa depan; ini bukan instruksi untuk menginstal dependensi rentan sekarang. Contoh notarisasi berbayar penuh ada di cookbooks/llamaindex_agent.py.

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())

Kredensial dan biaya model terpisah dari pembayaran MCP.

SDK TypeScript

sdk/typescript berisi sumber klien REST dan klien MCP, konfigurasi kompiler independen, tes lokal, dan manifes paketnya sendiri. Versi SDK 0.1.0 independen dari rilis registri 1.1.0.

cd sdk/typescript
npm install
npm test
npm run build

Manifes paket root mempertahankan identitas registri MCP kanonik dan versi rilis tetapi mengganti skrip/dependensi monorepo dengan perintah distribusi portabel. Ini bukan manifes orkestrasi workspace pribadi.

Isi repositori dan pemeriksaan ekspor

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 memeriksa impor sumber relatif dan referensi file Markdown, jalur paket skrip dan SDK, sintaks JSON, dan tidak adanya alias dependensi workspace. Kompilasi Python dan bangun SDK sebagai pemeriksaan sintaks tambahan. Tes offline kecuali Anda secara eksplisit menjalankan sandbox atau titik masuk agen.

Batasan operasional

• Ketinggian stratigrafi terindeks adalah indeks data harian yang didokumentasikan, bukan tip Bitcoin langsung atau bukti per-blok native.
• Penerimaan kalender OTS bukan konfirmasi Bitcoin. Pertahankan tanda terima terpisah dan verifikasi digest yang cocok dan attestation Bitcoin secara terpisah.
• Tanda tangan grounding, bukti ZK, dan tanda terima OTS menetapkan fakta yang berbeda; jangan deskripsikan satu sebagai yang lain.
• SDK berhenti pada kesalahan pembayaran. Jangan coba lagi panggilan berbayar secara membabi buta atau log bukti pembayaran. Simpan kredensial di manajer rahasia dan tinjau pengeluaran dan cakupan alat sebelum mengaktifkan agen.
• Kontrak OpenAPI mencakup REST; tools/list MCP langsung menjelaskan skema MCP yang dapat dieksekusi. Versi skema OpenAPI dan versi SDK tidak perlu cocok dengan rilis registri.
• Audit dependensi framework opsional sebelum menginstal atau memperbaruinya. Tidak ada dompet lokal, penandatanganan, atau kredensial penyelesaian yang dikirim.

Lisensi

MIT. Lihat LICENSE. Framework dan dependensi opsional mempertahankan lisensi dan ketentuannya sendiri.

🤖 Integrasi CrewAI

Mesin Data Bitcoin Stratigraphy mendukung MCPServerAdapter CrewAI secara native. Tempel cuplikan ini ke alur kerja Anda untuk segera melengkapi agen Anda dengan alat termodinamika dan penahanan status OpenTimestamps:

pip install crewai-tools[mcp]

Periksa crewai_cookbook.py untuk skrip eksekusi agen lengkap.