Mini Blockchain

🚀 基於Rust的區塊鏈命令行工具

本項目是一個基於Rust語言實現的簡單區塊鏈演示。通過一個輕量級的命令行應用，展示了核心Rust原理，並集成MCP服務器，讓區塊鏈功能得以在網絡中使用。

🚀 快速開始

前置條件

• Rust （最新穩定版本）
• Cargo

構建和運行

要使用Cargo創建並運行項目，請在終端中執行：

cargo new blockchain_app
cd blockchain_app && cargo run

⚠️ 重要提示

如果您克隆了此倉庫，只需進入項目文件夾並運行 cargo run 即可。

✨ 主要特性

• 實現了一個基本的區塊鏈，每個區塊包含索引、時間戳、數據、前一哈希和當前哈希。
• 提供菜單驅動的CLI，允許用戶添加新塊、打印當前區塊鏈以及驗證區塊鏈的完整性。
• 集成MCP服務器，可通過JSON命令與區塊鏈進行交互。

📦 安裝指南

前置依賴

• 安裝最新穩定版本的 Rust。
• 安裝 Cargo。

項目構建與運行

cargo new blockchain_app
cd blockchain_app && cargo run

💻 使用示例

基礎用法

當您運行應用程序時，CLI會顯示以下選項：

1. 添加塊：輸入數據以創建新塊。
2. 打印區塊鏈：顯示區塊鏈中的所有塊。
3. 驗證區塊鏈：確認每個塊正確鏈接。
4. 退出：關閉應用程序。

高級用法

MCP服務器交互

該項目包含一個MCP服務器，與CLI同時運行。它偵聽 127.0.0.1:7878 並允許外部客戶端通過JSON命令與區塊鏈交互。

可用的MCP命令

• latest_block：檢索區塊鏈中的最新塊。

  • 示例：

    echo '{"command": "latest_block"}' | nc 127.0.0.1 7878
    

  • 樣本輸出：

    {"status":"ok","message":"Latest block retrieved","block":{"index":0,"timestamp":"2025-02-26T10:06:59.931506+00:00","data":"Genesis Block","previous_hash":"0","hash":"f465878acf7be88a124fd7ebc9a3640793612023828d9af8ad237eefd4a1a22e"}}
    

• add_block：添加具有提供的數據的新塊。

  • 示例：

    echo '{"command": "add_block", "data": "sample transaction"}' | nc 127.0.0.1 7878
    

  • 樣本輸出：

    {"status":"ok","message":"Block added successfully"}
    

操作步驟

要與MCP服務器交互，請按照以下步驟操作：

1. 啟動區塊鏈應用程序。
2. 打開另一個終端，連接到MCP服務器：

   nc 127.0.0.1 7878
   

3. 輸入上述命令之一併按回車。

命令示例

# 添加新塊
echo '{"command": "add_block", "data": "test data"}' | nc 127.0.0.1 7878

# 檢索最新塊
echo '{"command": "latest_block"}' | nc 127.0.0.1 7878

🔧 技術細節

應用實現

該應用實現了一個基本的區塊鏈，每個區塊包括：

• 索引：塊在鏈中的位置。
• 時間戳：使用ISO 8601格式記錄的創建時間。
• 數據：用戶提供的內容。
• 前一哈希：前一塊的SHA-256哈希。
• 當前哈希：從塊內容計算得出的SHA-256哈希。

技術選型

• Rust：一種專注於安全性和性能的系統編程語言。
• sha2：用於計算SHA-256哈希。
• chrono：用於精確的時間戳，使用UTC時間。
• serde 和 serde_json：用於JSON序列化（在MCP通信中使用）。

📚 詳細文檔

注意事項

⚠️ 重要提示

• 確保區塊鏈應用程序和MCP服務器都在運行。
• 網絡客戶端（nc）必須安裝在系統上才能連接到MCP服務器。