Cryo MCP

🚀 Cryo-MCP Project Documentation

Cryo-MCP is a tool based on the MCP protocol for extracting blockchain datasets from on-chain data providers. It offers the following capabilities:

• Query Blockchain Data: Quickly retrieve the required data through flexible block ranges and filters.
• Output Format Conversion: Support output in JSON, CSV, and Parquet formats.
• SQL Query Support: Allow users to directly use SQL queries in DuckDB to extract data.

🚀 Quick Start

📦 Installation

pip install "duckdb>=0.7.1"

💻 Usage Examples

🔍 Basic Usage

1. Query Block Data

# Download basic information of the latest 100 blocks
client.query_dataset('blocks', blocks_from_latest=100)

# Download block data within a specified range
client.query_dataset('blocks', blocks='15M:15.01M')

2. Filter Data for Specific Contracts

# Query transaction records of the USDC contract
client.query_dataset(
    'transactions',
    contract='0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48'
)

# Filter log data within a specific block range
client.query_dataset('logs', blocks='15M:15.01M', contract='0xabc123...')

3. Customize Output Format

# Download data in CSV format with specified columns
client.query_dataset(
    'blocks',
    blocks_from_latest=100,
    include_columns=['number', 'timestamp'],
    output_format='csv'
)

# Download transaction data in Parquet format
client.query_dataset('transactions', blocks_from_latest=100, output_format='parquet')

⚙️ Advanced Usage

Use SQL for Data Analysis

Cryo-MCP supports executing complex SQL queries through DuckDB to assist users in in-depth data analysis.

Example: Analyze the Number of Transactions in Blocks

# Download data and execute SQL queries
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']
)

🔧 Technical Details

cryo-mcp/
├── cryo_mcp/           # Main program package directory
│   ├── __init__.py     # Package initialization file
│   ├── server.py       # MCP server implementation
│   └── sql.py          # SQL query function module
└── tests/              # Test directory
    └── test_*.py       # Various test case files

🧪 Run Tests

uv run pytest

📄 License

This project is open-sourced under the MIT license.

🙏 Acknowledgments

• Built on the Cryo tool developed by Paradigm.
• Uses the MCP protocol for API communication.