Bitcoin Stratigraphy MCP

공식

엔터프라이즈급, L402 게이트 방식의 AI 공증 허브 및 MCP 데이터 서버로, 열역학적 비트코인 원격 측정과 OpenTimestamps 상태 앵커링을 제공합니다.

GitHub
1
이 MCP 사용해 보기스폰서

Bitcoin Stratigraphy MCP(으)로 무엇을 할 수 있나요?

  • 인덱싱된 층서 데이터 탐색 — AI에게 stratigraphy.list를 호출하여 사용 가능한 날짜, 높이, 범위 및 지표를 확인하도록 요청하세요.
  • 증명 작업 목록 확인 — 유료 호출 전에 proof.list를 사용하여 지원되는 공증 및 검증 스키마를 확인하세요.
  • 공증 배치 요청 — 100회 호출 L402 배치로 proof.notarize 챌린지를 요청한 다음, Lightning을 통해 결제하여 Bitcoin에 해시를 고정하세요.
  • 무료 샌드박스 클라이언트 실행 — 서명이나 결제 없이 MCP 연결을 테스트하려면 지갑이 필요 없는 Node 또는 Python 예제를 실행하세요.
  • LangChain ReAct 에이전트 구축 — 문서화된 MCP 어댑터를 사용하여 층서 및 증명 메타데이터를 조회하는 무료 도구 전용 에이전트를 설정하세요.

호스팅형 MCP 서버

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

Claude Code, Codex, Cursor 등에 설치됩니다

문서

Bitcoin Stratigraphy MCP — 개발자 배포

MCP L402 OpenTimestamps LangChain LlamaIndex

릴리스: 1.1.0 · MCP 레지스트리 이름: crstrogish/bitcoin-stratigraphy

Bitcoin Stratigraphy MCP 엔진을 위한 독립형 원격 우선 통합 저장소입니다: 레지스트리 메타데이터, OpenAPI 계약, 의존성 없는 클라이언트, 네이티브 프레임워크 에이전트 예제를 포함합니다. 무료 샌드박스에는 Replit 작업공간, 지갑, API 키 또는 모델 제공자 계정이 필요하지 않습니다.

범위 및 보안 상태

이 번들은 호스팅 엔진에 연결됩니다. 완전한 결제 서버를 오프라인으로 실행하는 기능을 포함하거나 주장하지 않습니다. 클라이언트 소스는 라이브 서비스 또는 독립적으로 운영되는 호환 MCP 엔드포인트에 대해 로컬에서 실행할 수 있습니다. 작업공간 별칭, 공급된 자격 증명, 개인 서명 키, 운영자 상태 또는 상위 저장소에 대한 의존성이 없습니다.

LangChain 실행이 지원됩니다. LlamaIndex 소스는 보존되지만, 의존성 설치 및 실행은 일시적으로 사용할 수 없습니다: 해당 NLTK 의존성이 GHSA-8mgp-746c-j5xp의 영향을 받습니다. LlamaIndex 요구사항 파일은 의도적으로 아무것도 설치하지 않습니다. 보안 검사를 우회하거나 배지를 지원되는 실행의 주장으로 취급하지 마십시오. 안전하고 완전한 의존성 트리를 감사한 후에만 설치를 복원하십시오.

라이브 MCP 엔진에 연결

표면URL
Streamable HTTP MCPhttps://bitcoin-stratigraphy-dashboard.replit.app/mcp
개발자 포털https://bitcoin-stratigraphy-dashboard.replit.app/docs
라이브 OpenAPIhttps://bitcoin-stratigraphy-dashboard.replit.app/openapi.json

모든 Streamable HTTP 클라이언트에서 MCP URL을 사용하십시오. 클라이언트가 URL 기반 MCP 구성을 지원하는 경우 mcp.json을 가져오십시오. 일부 호스트는 자체 구성 형식에서 명시적 전송 유형을 요구합니다. 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를 통해 선불 자격 증명을 제공하거나, 명시적 지출 한도가 있는 신뢰할 수 있는 루프백 Streamable HTTP 지갑 프록시를 L402_PROXY_URL와 함께 제공하십시오. 자격 증명이나 모델 제공자 비밀을 커밋하지 마십시오. 이전의 일회성 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 레지스트리 ID와 릴리스 버전을 유지하지만 모노레포 스크립트/의존성을 휴대용 배포 명령으로 대체합니다. 개인 작업공간 오케스트레이션 매니페스트가 아닙니다.

저장소 내용 및 내보내기 검사

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 데이터 엔진은 CrewAI의 MCPServerAdapter을 네이티브로 지원합니다. 이 스니펫을 워크플로우에 삽입하여 에이전트에 열역학 도구와 OpenTimestamps 상태 앵커링을 즉시 장착하십시오:

pip install crewai-tools[mcp]

전체 에이전트 실행 스크립트는 crewai_cookbook.py을 확인하십시오.