Bitcoin Stratigraphy MCP

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

Bitcoin Stratigraphy MCP — डेवलपर वितरण

रिलीज़: 1.1.0 · MCP रजिस्ट्री नाम: crstrogish/bitcoin-stratigraphy

Bitcoin Stratigraphy MCP इंजन के लिए एक स्टैंडअलोन, रिमोट-फर्स्ट एकीकरण रिपॉजिटरी: रजिस्ट्री मेटाडेटा, OpenAPI अनुबंध, डिपेंडेंसी-मुक्त क्लाइंट, और नेटिव फ्रेमवर्क एजेंट उदाहरण। मुफ्त सैंडबॉक्स के लिए किसी Replit वर्कस्पेस, वॉलेट, API कुंजी, या मॉडल प्रदाता खाते की आवश्यकता नहीं है।

दायरा और सुरक्षा स्थिति

यह बंडल होस्टेड इंजन से जुड़ता है; इसमें पूर्ण सेटलमेंट सर्वर को ऑफ़लाइन चलाने का दावा या समावेश नहीं है। क्लाइंट स्रोतों को लाइव सेवा या स्वतंत्र रूप से संचालित संगत MCP एंडपॉइंट के विरुद्ध स्थानीय रूप से चलाया जा सकता है। कोई वर्कस्पेस उपनाम, वेंडर किए गए क्रेडेंशियल, निजी हस्ताक्षर कुंजी, ऑपरेटर स्थिति, या पैरेंट रिपॉजिटरी पर निर्भरता नहीं है।

LangChain निष्पादन समर्थित है। LlamaIndex स्रोत संरक्षित है, लेकिन डिपेंडेंसी इंस्टॉलेशन और निष्पादन अस्थायी रूप से अनुपलब्ध है: इसकी NLTK डिपेंडेंसी GHSA-8mgp-746c-j5xp से प्रभावित है। LlamaIndex आवश्यकताएँ फ़ाइल जानबूझकर कुछ भी इंस्टॉल नहीं करती है। सुरक्षा जाँचों को बायपास न करें या बैज को समर्थित निष्पादन के दावे के रूप में न मानें। सुरक्षित, पूर्ण डिपेंडेंसी ट्री का ऑडिट करने के बाद ही इंस्टॉलेशन पुनर्स्थापित करें।

लाइव MCP इंजन से कनेक्ट करें

सतह	URL
स्ट्रीमेबल HTTP MCP	https://bitcoin-stratigraphy-dashboard.replit.app/mcp
डेवलपर पोर्टल	https://bitcoin-stratigraphy-dashboard.replit.app/docs
लाइव OpenAPI	https://bitcoin-stratigraphy-dashboard.replit.app/openapi.json

किसी भी स्ट्रीमेबल HTTP क्लाइंट में MCP URL का उपयोग करें। mcp.json आयात करें जहाँ आपका क्लाइंट URL-आधारित MCP कॉन्फ़िगरेशन का समर्थन करता है; कुछ होस्ट को अपने स्वयं के कॉन्फ़िगरेशन प्रारूप में स्पष्ट परिवहन प्रकार की आवश्यकता होती है। smithery.yaml कैननिकल रिमोट रजिस्ट्रेशन मेटाडेटा है, न कि स्थानीय-सर्वर लॉन्च रेसिपी।

सर्वर 15 कैननिकल क्षमताओं का विज्ञापन करता है। initialize और tools/list मुफ्त प्रोटोकॉल डिस्कवरी ऑपरेशन हैं। ठीक दो टूल निष्पादन मुफ्त हैं:

टूल	तर्क	उद्देश्य
stratigraphy.list	{}	अनुक्रमित तिथियाँ/ऊँचाइयाँ, सीमाएँ और उपलब्ध मेट्रिक्स खोजें
proof.list	{}	समर्थित प्रमाण संचालन और स्कीमा मेटाडेटा सूचीबद्ध करें

कैटलॉग डिस्कवरी भुगतान प्राधिकरण नहीं है। अन्य कैननिकल टूल को सशुल्क पहुँच की आवश्यकता होती है; खरीद को अधिकृत करने से पहले लाइव स्कीमा और भुगतान शर्तों की जाँच करें।

मुफ्त सैंडबॉक्स क्विकस्टार्ट — कोई वॉलेट नहीं

Node.js 22 या नया

इस रिपॉजिटरी के रूट से, बिना किसी पैकेज इंस्टॉलेशन के:

node examples/free-sandbox.mjs

यह MCP पर बातचीत करता है, आरंभिक अधिसूचना भेजता है, फिर केवल stratigraphy.list और proof.list को कॉल करता है। यह हस्ताक्षर नहीं करता, भुगतान नहीं करता, क्रेडेंशियल संलग्न नहीं करता, या LLM अनुरोध नहीं करता। यदि मुफ्त कॉल HTTP 402 लौटाता है तो यह भुगतान करने के बजाय विफल हो जाता है।

अपने स्वयं के संगत एंडपॉइंट का उपयोग करने के लिए:

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

यह एक क्लाइंट कनेक्शन है, प्रोडक्शन इंजन शुरू करने का आदेश नहीं।

Python 3.11 या नया

बंडल किया गया क्लाइंट मानक लाइब्रेरी के साथ काम करता है; कोई फ्रेमवर्क इंस्टॉलेशन आवश्यक नहीं है:

python -m examples.free_sandbox

समतुल्य कॉपी-पेस्ट Python:

from sdk.python.client import BitcoinStratigraphyClient

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

रिपॉजिटरी रूट से कोड चलाएँ ताकि sdk नेमस्पेस आयात योग्य हो। TLS सत्यापन सक्षम रहता है। यदि आपका संगठन निजी CA का उपयोग करता है, तो उसका विश्वसनीय प्रमाणपत्र स्टोर कॉन्फ़िगर करें; सत्यापन अक्षम न करें।

L402: 100-कॉल मैक्रो-मैकरून बैच

सशुल्क क्षमताएँ टूल-स्कोप्ड क्रेडेंशियल का उपयोग करती हैं। बैच का अनुरोध करने के लिए, शामिल करें:

X-L402-Batch-Size: 100

उदाहरण के लिए, यह अनुरोध नोटराइज़ेशन बैच चैलेंज माँगता है; यह इनवॉइस का भुगतान नहीं करता:

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, L402 WWW-Authenticate चैलेंज, इनवॉइस राशि, समाप्ति और सटीक टूल स्कोप का निरीक्षण करें।
2. केवल स्पष्ट खर्च सीमा वाले विश्वसनीय Lightning वॉलेट/क्लाइंट के माध्यम से भुगतान करें। सत्यापित करें कि सेटलमेंट प्रमाण चुनौती दिए गए भुगतान हैश से मेल खाता है।
3. बैच हेडर के साथ उसी टूल कॉल को दोबारा आज़माएँ और:

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

पंजीकृत नोटराइज़ेशन कोट 250 sats/कॉल × 100 = 25,000 sats है। लाइव इनवॉइस आधिकारिक है; रजिस्ट्री लक्ष्य-मूल्य उदाहरण मूल्य गारंटी नहीं हैं। proof.notarize पास अन्य सशुल्क टूल अनलॉक नहीं करता। बजट, समाप्ति, निरसन और विरासत में मिली शर्तें हर उपयोग पर लागू होती हैं। एटेन्यूएशन स्कोप को प्रत्यायोजित या संकीर्ण करता है; यह पैरेंट बजट को रीसेट नहीं करता।

नेटिव फ्रेमवर्क एडेप्टर वॉलेट नहीं हैं। L402_AUTHORIZATION के माध्यम से प्रीपेड क्रेडेंशियल प्रदान करें, या स्पष्ट खर्च सीमा के साथ L402_PROXY_URL के माध्यम से विश्वसनीय लूपबैक स्ट्रीमेबल HTTP वॉलेट प्रॉक्सी प्रदान करें। क्रेडेंशियल या मॉडल-प्रदाता रहस्य दोनों को कमिट न करें। पुराने वन-शॉट SDK भुगतान कॉलबैक स्वचालित मैक्रो-मैकरून बैचिंग कार्यान्वयन नहीं हैं।

LangChain: नेटिव MCP और ReAct लूप

पुराने MCP 1.x वातावरण के बजाय एक अलग उपभोक्ता Python वातावरण का उपयोग करें:

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

डिफ़ॉल्ट मोड केवल टूल खोजता है। LLM और सशुल्क नोटराइज़ेशन में ऑप्ट-इन करने के लिए, अपने सीक्रेट मैनेजर के माध्यम से अपनी प्रदाता कुंजी और प्रीपेड proof.notarize बैच क्रेडेंशियल कॉन्फ़िगर करें, फिर चलाएँ:

python cookbooks/langchain_agent.py --run

कॉपी-पेस्ट फ्री-टूल-ओनली ReAct लूप (MCP कॉल मुफ्त हैं; मॉडल उपयोग आपके मॉडल प्रदाता द्वारा बिल किया जाता है):

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 वर्तमान ReAct मॉडल → टूल → अवलोकन लूप लागू करता है। अंडरस्कोर उपनाम मॉडल-प्रदाता नामकरण नियमों को संतुष्ट करते हैं; रैपर मूल डॉटेड रिमोट टूल नाम बनाए रखते हैं।

LlamaIndex: संरक्षित नेटिव एजेंट उदाहरण

डिपेंडेंसी सुरक्षा होल्ड हटने तक केवल-स्रोत। निम्नलिखित कॉपी-पेस्ट उदाहरण भविष्य के ऑडिट किए गए वातावरण के लिए समर्थित API आकार का दस्तावेज़ीकरण करता है; यह अभी कमजोर डिपेंडेंसी स्थापित करने का निर्देश नहीं है। पूर्ण सशुल्क-नोटराइज़ेशन उदाहरण 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())

मॉडल क्रेडेंशियल और शुल्क MCP भुगतान से अलग हैं।

TypeScript SDK

sdk/typescript में REST क्लाइंट और MCP क्लाइंट स्रोत, स्वतंत्र कंपाइलर कॉन्फ़िगरेशन, स्थानीय परीक्षण और अपना स्वयं का पैकेज मैनिफेस्ट दोनों शामिल हैं। SDK संस्करण 0.1.0 रजिस्ट्री रिलीज़ 1.1.0 से स्वतंत्र है।

cd sdk/typescript
npm install
npm test
npm run build

रूट पैकेज मैनिफेस्ट कैननिकल MCP रजिस्ट्री पहचान और रिलीज़ संस्करण बनाए रखता है, लेकिन मोनोरेपो स्क्रिप्ट/डिपेंडेंसी को पोर्टेबल वितरण कमांड से बदल देता है। यह निजी वर्कस्पेस ऑर्केस्ट्रेशन मैनिफेस्ट नहीं है।

रिपॉजिटरी सामग्री और निर्यात जाँच

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 सापेक्ष स्रोत आयात और Markdown फ़ाइल संदर्भ, स्क्रिप्ट और SDK पैकेज पथ, JSON सिंटैक्स और वर्कस्पेस डिपेंडेंसी उपनामों की अनुपस्थिति की जाँच करता है। अतिरिक्त सिंटैक्स जाँच के रूप में Python संकलित करें और SDK बनाएँ। परीक्षण ऑफ़लाइन हैं जब तक कि आप स्पष्ट रूप से सैंडबॉक्स या एजेंट एंट्रीपॉइंट नहीं चलाते।

परिचालन सीमाएँ

• अनुक्रमित स्ट्रैटिग्राफी ऊँचाइयाँ एक दस्तावेजी दैनिक-डेटा सूचकांक हैं, लाइव Bitcoin टिप या नेटिव प्रति-ब्लॉक प्रोवेनेंस नहीं।
• OTS कैलेंडर स्वीकृति Bitcoin पुष्टिकरण नहीं है। अलग रसीद संरक्षित करें और उसके मिलान डाइजेस्ट और Bitcoin प्रमाणीकरण को अलग से सत्यापित करें।
• ग्राउंडिंग हस्ताक्षर, ZK प्रमाण और OTS रसीदें अलग-अलग तथ्य स्थापित करते हैं; एक को दूसरे के रूप में वर्णित न करें।
• SDK भुगतान त्रुटियों पर रुक जाते हैं। सशुल्क कॉल को आँख बंद करके दोबारा न आज़माएँ या भुगतान प्रमाण लॉग न करें। क्रेडेंशियल को सीक्रेट मैनेजर में संग्रहीत करें और एजेंट सक्षम करने से पहले खर्च और टूल स्कोप की समीक्षा करें।
• OpenAPI अनुबंध REST को कवर करता है; लाइव MCP tools/list निष्पादन योग्य MCP स्कीमा का वर्णन करता है। OpenAPI स्कीमा संस्करण और SDK संस्करण को रजिस्ट्री रिलीज़ से मेल खाने की आवश्यकता नहीं है।
• वैकल्पिक फ्रेमवर्क डिपेंडेंसी को स्थापित या अपडेट करने से पहले ऑडिट करें। कोई स्थानीय वॉलेट, हस्ताक्षर या सेटलमेंट क्रेडेंशियल शिप नहीं किए जाते हैं।

लाइसेंस

MIT। LICENSE देखें। फ्रेमवर्क और वैकल्पिक डिपेंडेंसी अपने स्वयं के लाइसेंस और शर्तों को बनाए रखते हैं।

🤖 CrewAI एकीकरण

Bitcoin Stratigraphy Data Engine नेटिव रूप से CrewAI के MCPServerAdapter का समर्थन करता है। अपने एजेंटों को थर्मोडायनामिक टूल और OpenTimestamps स्टेट एंकरिंग से तुरंत सुसज्जित करने के लिए इस स्निपेट को अपने वर्कफ़्लो में डालें:

pip install crewai-tools[mcp]

पूर्ण एजेंट निष्पादन स्क्रिप्ट के लिए crewai_cookbook.py देखें।