Cryo MCP

🚀 Cryo - MCP 項目文檔

Cryo - MCP 是一款基於 MCP 協議的實用工具，主要用於從鏈上數據提供商處提取區塊鏈數據集。它具備靈活的數據查詢、多樣的輸出格式轉換以及 SQL 查詢功能，能高效滿足用戶對區塊鏈數據的處理需求。

🚀 快速開始

📦 安裝指南

安裝所需依賴，可使用以下命令：

pip install "duckdb>=0.7.1"

💻 使用示例

基礎用法

以下是一些基礎的使用示例，展示如何查詢區塊鏈數據：

# 下載最近 100 個區塊的基本信息
client.query_dataset('blocks', blocks_from_latest=100)

# 下載指定範圍的區塊數據
client.query_dataset('blocks', blocks='15M:15.01M')

# 查詢 USDC 合約的交易記錄
client.query_dataset(
    'transactions',
    contract='0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
)

# 篩選特定塊範圍內的日誌數據
client.query_dataset('logs', blocks='15M:15.01M', contract='0xabc123...')

# 下載指定列的 CSV 格式數據
client.query_dataset(
    'blocks',
    blocks_from_latest=100,
    include_columns=['number', 'timestamp'],
    output_format='csv'
)

# 以 Parquet 格式下載交易數據
client.query_dataset('transactions', blocks_from_latest=100, output_format='parquet')

高級用法

Cryo - MCP 支持通過 DuckDB 執行復雜的 SQL 查詢，以進行深度數據分析。以下是分析區塊交易數量的示例：

# 下載數據並執行 SQL 查詢
client.query_sql(
    query="""
        SELECT 
            block_number,
            COUNT(*) as transaction_count
        FROM read_parquet('/path/to/transactions.parquet')
        GROUP BY block_number
        ORDER BY transaction_count DESC
        LIMIT 10
    """,
    files=['/path/to/transactions.parquet']
)

✨ 主要特性

• 查詢區塊鏈數據：可通過靈活的塊範圍和過濾器快速檢索所需數據。
• 輸出格式轉換：支持 JSON、CSV 和 Parquet 格式的輸出。
• SQL 查詢支持：允許用戶直接在 DuckDB 中使用 SQL 查詢提取數據。

📚 詳細文檔

項目結構

項目的文件結構如下：

cryo-mcp/
├── cryo_mcp/           # 主程序包目錄
│   ├── __init__.py     # 包初始化文件
│   ├── server.py       # MCP 服務器實現
│   └── sql.py          # SQL 查詢功能模塊
└── tests/              # 測試目錄
    └── test_*.py       # 各種測試用例文件

運行測試

使用以下命令運行測試：

uv run pytest

📄 許可證

本項目使用 MIT 協議開源。

致謝

• 構建於 Paradigm 開發的 Cryo 工具之上。
• 使用 MCP 協議 進行 API 通信。