Bitcoin Stratigraphy MCP

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

Bitcoin Stratigraphy MCP — Phân phối cho nhà phát triển

Bản phát hành: 1.1.0 · Tên đăng ký MCP: crstrogish/bitcoin-stratigraphy

Một kho lưu trữ tích hợp độc lập, ưu tiên từ xa cho công cụ Bitcoin Stratigraphy MCP: siêu dữ liệu đăng ký, hợp đồng OpenAPI, máy khách không phụ thuộc và ví dụ tác nhân framework gốc. Không cần không gian làm việc Replit, ví, khóa API hoặc tài khoản nhà cung cấp mô hình cho sandbox miễn phí.

Phạm vi và trạng thái bảo mật

Gói này kết nối đến công cụ lưu trữ; nó không chứa hoặc tuyên bố chạy máy chủ thanh toán hoàn chỉnh ngoại tuyến. Mã nguồn máy khách có thể chạy cục bộ với dịch vụ trực tiếp hoặc một điểm cuối MCP tương thích được vận hành độc lập. Không có bí danh không gian làm việc, thông tin xác thực được bán kèm, khóa ký riêng, trạng thái vận hành hoặc phụ thuộc vào kho lưu trữ cha.

Hỗ trợ thực thi LangChain. Mã nguồn LlamaIndex được giữ nguyên, nhưng cài đặt phụ thuộc và thực thi tạm thời không khả dụng: phụ thuộc NLTK của nó bị ảnh hưởng bởi GHSA-8mgp-746c-j5xp. Tệp yêu cầu LlamaIndex cố ý không cài đặt gì. Không bỏ qua kiểm tra bảo mật hoặc coi huy hiệu là tuyên bố hỗ trợ thực thi. Chỉ khôi phục cài đặt sau khi kiểm tra một cây phụ thuộc an toàn, hoàn chỉnh.

Kết nối với công cụ MCP trực tiếp

Bề mặt	URL
MCP HTTP có thể truyền phát	https://bitcoin-stratigraphy-dashboard.replit.app/mcp
Cổng thông tin nhà phát triển	https://bitcoin-stratigraphy-dashboard.replit.app/docs
OpenAPI trực tiếp	https://bitcoin-stratigraphy-dashboard.replit.app/openapi.json

Sử dụng URL MCP trong bất kỳ máy khách HTTP có thể truyền phát nào. Nhập mcp.json nơi máy khách của bạn hỗ trợ cấu hình MCP dựa trên URL; một số máy chủ yêu cầu loại truyền tải rõ ràng trong định dạng cấu hình riêng của họ. smithery.yaml là siêu dữ liệu đăng ký từ xa chuẩn, không phải là công thức khởi chạy máy chủ cục bộ.

Máy chủ quảng bá 15 khả năng chuẩn. initialize và tools/list là các thao tác khám phá giao thức miễn phí. Chính xác hai lần thực thi công cụ là miễn phí:

Công cụ	Đối số	Mục đích
stratigraphy.list	{}	Khám phá ngày/độ cao được lập chỉ mục, ranh giới và số liệu khả dụng
proof.list	{}	Liệt kê các thao tác chứng minh được hỗ trợ và siêu dữ liệu lược đồ

Khám phá danh mục không phải là ủy quyền thanh toán. Các công cụ chuẩn khác yêu cầu truy cập trả phí; truy vấn lược đồ trực tiếp và điều khoản thanh toán trước khi ủy quyền mua hàng.

Bắt đầu nhanh sandbox miễn phí — không cần ví

Node.js 22 trở lên

Từ thư mục gốc của kho lưu trữ này, không cần cài đặt gói:

node examples/free-sandbox.mjs

Thao tác này đàm phán MCP, gửi thông báo khởi tạo, sau đó chỉ gọi stratigraphy.list và proof.list. Nó không ký, thanh toán, đính kèm thông tin xác thực hoặc thực hiện yêu cầu LLM. Nó thất bại thay vì thanh toán nếu một cuộc gọi miễn phí trả về HTTP 402.

Để sử dụng điểm cuối tương thích của riêng bạn:

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

Đây là kết nối máy khách, không phải lệnh để khởi động công cụ sản xuất.

Python 3.11 trở lên

Máy khách đi kèm hoạt động với thư viện chuẩn; không cần cài đặt framework:

python -m examples.free_sandbox

Mã Python sao chép-dán tương đương:

from sdk.python.client import BitcoinStratigraphyClient

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

Chạy mã từ thư mục gốc của kho lưu trữ để không gian tên sdk có thể nhập được. Xác minh TLS vẫn được bật. Nếu tổ chức của bạn sử dụng CA riêng, hãy cấu hình kho chứng chỉ đáng tin cậy của nó; không tắt xác minh.

L402: Gói Macro-Macaroon 100 cuộc gọi

Các khả năng trả phí sử dụng thông tin xác thực theo phạm vi công cụ. Để yêu cầu một gói, bao gồm:

X-L402-Batch-Size: 100

Ví dụ: yêu cầu này hỏi về thử thách gói công chứng; nó không thanh toán hóa đơn:

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. Kiểm tra HTTP 402, thử thách L402 WWW-Authenticate, số tiền hóa đơn, ngày hết hạn và phạm vi công cụ chính xác.
2. Chỉ thanh toán qua ví/máy khách Lightning đáng tin cậy với giới hạn chi tiêu rõ ràng. Xác minh bằng chứng thanh toán khớp với hàm băm thanh toán được thử thách.
3. Thử lại cùng một cuộc gọi công cụ với tiêu đề gói và:

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

Báo giá công chứng đã đăng ký là 250 sats/cuộc gọi × 100 = 25.000 sats. Hóa đơn trực tiếp có thẩm quyền; ví dụ giá mục tiêu trong đăng ký không phải là đảm bảo giá. Thẻ proof.notarize không mở khóa các công cụ trả phí khác. Ngân sách, hết hạn, thu hồi và điều khoản kế thừa vẫn áp dụng cho mọi lần sử dụng. Suy giảm ủy quyền hoặc thu hẹp phạm vi; nó không đặt lại ngân sách cha.

Bộ điều hợp framework gốc không phải là ví. Cung cấp thông tin xác thực trả trước qua L402_AUTHORIZATION, hoặc một proxy ví Streamable HTTP loopback đáng tin cậy qua L402_PROXY_URL với giới hạn chi tiêu rõ ràng. Không cam kết thông tin xác thực hoặc bí mật nhà cung cấp mô hình. Các lệnh gọi lại thanh toán SDK một lần cũ không phải là triển khai gộp Macro-Macaroon tự động.

LangChain: Vòng lặp MCP gốc và ReAct

Sử dụng môi trường Python tiêu dùng riêng, không phải môi trường MCP 1.x cũ:

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

Chế độ mặc định chỉ khám phá công cụ. Để chọn LLM và công chứng trả phí, cấu hình khóa nhà cung cấp của bạn và thông tin xác thực gói proof.notarize trả trước qua trình quản lý bí mật của bạn, sau đó chạy:

python cookbooks/langchain_agent.py --run

Vòng lặp ReAct chỉ công cụ miễn phí sao chép-dán (cuộc gọi MCP miễn phí; sử dụng mô hình được thanh toán bởi nhà cung cấp mô hình của bạn):

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 triển khai vòng lặp ReAct hiện tại mô hình → công cụ → quan sát. Bí danh gạch dưới đáp ứng quy tắc đặt tên của nhà cung cấp mô hình; trình bao bọc giữ tên công cụ từ xa có dấu chấm gốc.

LlamaIndex: Ví dụ tác nhân gốc được giữ nguyên

Chỉ mã nguồn cho đến khi lệnh giữ phụ thuộc bảo mật được dỡ bỏ. Ví dụ sao chép-dán sau đây ghi lại hình dạng API được hỗ trợ cho một môi trường được kiểm tra trong tương lai; nó không phải là hướng dẫn cài đặt phụ thuộc dễ bị tổn thương ngay bây giờ. Ví dụ công chứng trả phí đầy đủ là 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())

Thông tin xác thực mô hình và phí tách biệt với thanh toán MCP.

SDK TypeScript

sdk/typescript chứa cả mã nguồn máy khách REST và máy khách MCP, cấu hình trình biên dịch độc lập, kiểm tra cục bộ và tệp kê khai gói riêng. Phiên bản SDK 0.1.0 độc lập với bản phát hành đăng ký 1.1.0.

cd sdk/typescript
npm install
npm test
npm run build

Tệp kê khai gói gốc giữ danh tính đăng ký MCP chuẩn và phiên bản phát hành nhưng thay thế tập lệnh/phụ thuộc monorepo bằng lệnh phân phối di động. Nó không phải là tệp kê khai điều phối không gian làm việc riêng.

Nội dung kho lưu trữ và kiểm tra xuất khẩu

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 kiểm tra nhập khẩu nguồn tương đối và tham chiếu tệp Markdown, đường dẫn gói tập lệnh và SDK, cú pháp JSON và không có bí danh phụ thuộc không gian làm việc. Biên dịch Python và xây dựng SDK như các kiểm tra cú pháp bổ sung. Kiểm tra ngoại tuyến trừ khi bạn chạy rõ ràng một điểm vào sandbox hoặc tác nhân.

Ranh giới vận hành

• Độ cao địa tầng được lập chỉ mục là chỉ số dữ liệu hàng ngày được ghi lại, không phải đỉnh Bitcoin trực tiếp hoặc nguồn gốc gốc theo khối.
• Chấp nhận lịch OTS không phải là xác nhận Bitcoin. Giữ biên nhận tách rời và xác minh hàm băm khớp và chứng thực Bitcoin của nó riêng biệt.
• Chữ ký neo, bằng chứng ZK và biên nhận OTS thiết lập các sự kiện khác nhau; không mô tả cái này như cái kia.
• SDK dừng khi có lỗi thanh toán. Không thử lại cuộc gọi trả phí một cách mù quáng hoặc ghi nhật ký bằng chứng thanh toán. Lưu trữ thông tin xác thực trong trình quản lý bí mật và xem xét chi tiêu và phạm vi công cụ trước khi bật tác nhân.
• Hợp đồng OpenAPI bao gồm REST; tools/list MCP trực tiếp mô tả lược đồ MCP thực thi. Phiên bản lược đồ OpenAPI và phiên bản SDK không cần khớp với bản phát hành đăng ký.
• Kiểm tra phụ thuộc framework tùy chọn trước khi cài đặt hoặc cập nhật chúng. Không có ví cục bộ, ký hoặc thông tin xác thực thanh toán nào được phân phối.

Giấy phép

MIT. Xem LICENSE. Framework và phụ thuộc tùy chọn giữ giấy phép và điều khoản riêng của chúng.

🤖 Tích hợp CrewAI

Công cụ dữ liệu Bitcoin Stratigraphy hỗ trợ gốc MCPServerAdapter của CrewAI. Thả đoạn mã này vào quy trình làm việc của bạn để trang bị ngay cho tác nhân của bạn các công cụ nhiệt động lực học và neo trạng thái OpenTimestamps:

pip install crewai-tools[mcp]

Kiểm tra crewai_cookbook.py để biết tập lệnh thực thi tác nhân đầy đủ.