Cryo MCP

🚀 Cryo - MCP プロジェクトドキュメント

Cryo - MCP は、MCP プロトコルに基づくツールで、ブロックチェーンデータセットをチェーン上のデータプロバイダーから抽出するために使用されます。以下の機能をサポートしています。

• ブロックチェーンデータのクエリ：柔軟なブロック範囲とフィルターを通じて、必要なデータを迅速に検索します。
• 出力形式の変換：JSON、CSV、Parquet 形式の出力をサポートします。
• SQL クエリのサポート：ユーザーが DuckDB で直接 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']
)

🔧 技術詳細

プロジェクト構造

cryo-mcp/
├── cryo_mcp/           # 主プログラムパッケージディレクトリ
│   ├── __init__.py     # パッケージ初期化ファイル
│   ├── server.py       # MCP サーバー実装
│   └── sql.py          # SQL クエリ機能モジュール
└── tests/              # テストディレクトリ
    └── test_*.py       # 各種テストケースファイル

テストの実行

uv run pytest

📄 ライセンス

このプロジェクトは MIT ライセンスでオープンソース化されています。

謝辞

• Paradigm が開発した Cryo ツールをベースに構築されています。
• MCP プロトコル を使用して API 通信を行っています。