Blockchain Signer

🚀 MCP 區塊鏈服務器 & DApp

本項目是一個安全系統，允許 AI 助手與區塊鏈智能合約交互。它解決了 AI 與區塊鏈集成中的關鍵問題，在讓 AI 助手讀取區塊鏈數據並準備交易的同時，確保用戶能完全控制其私鑰和交易簽名。

🚀 快速開始

若要安裝項目：

# 使用 npm 安裝依賴項
npm install

# 啟動開發服務器
npm run dev

# 構建生產版本
npm run build

✨ 主要特性

MCP 服務器功能

• 區塊鏈數據訪問：可讀取餘額、合同狀態和其他鏈上數據。
• 交易準備：能夠創建待用戶批准的未簽名交易。
• 多鏈支持：適用於 Ethereum、Polygon 和其他 EVM 兼容鏈。
• 智能合約交互：可從受支持網絡上的已驗證智能合約中讀取數據。
• 安全優先設計：私鑰永遠不會離開用戶的錢包。

Web DApp 功能

• 錢包集成：能與 MetaMask 和其他 Web3 錢包連接。
• 交易審查：提供清晰的用戶界面，方便用戶在簽名前查看交易細節。
• 交易簽名：支持使用連接的錢包簽署交易。
• 交易跟蹤：可監控已提交事務的狀態。
• 移動兼容性：採用響應式設計，適用於所有設備。

📦 安裝指南

若要安裝項目：

# 使用 npm 安裝依賴項
npm install

# 啟動開發服務器
npm run dev

# 構建生產版本
npm run build

💻 使用示例

基礎用法

# 使用 npm 安裝依賴項
npm install

# 啟動開發服務器
npm run dev

# 構建生產版本
npm run build

高級用法

# MCP SDK 問題 - 直接從 GitHub 安裝
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdk

📚 詳細文檔

概述

本項目解決了 AI 與區塊鏈集成中的關鍵挑戰：讓 AI 助手讀取區塊鏈數據並準備交易，同時保證用戶對交易簽名和私鑰擁有獨家控制權。

該系統包括：

1. MCP 服務器：一個模型上下文協議服務器，將區塊鏈操作作為工具提供給 AI 助手使用。
2. Web DApp：一個 React 應用程序，提供用戶界面用於錢包連接和交易簽名。
3. 數據庫：PostgreSQL 數據庫用於存儲用戶、API 密鑰和事務記錄。
4. 緩存：Redis 用於緩存頻繁訪問的數據。

安全原則

1. 私鑰隔離：密鑰永遠不會離開用戶的錢包。
2. 交易驗證：提供清晰的用戶界面用於審查交易細節。
3. API 認證：採用安全的 API 密鑰管理。
4. 速率限制：防止濫用。
5. 緩存：Redis 用於緩存頻繁訪問的數據。
6. 數據庫：PostgreSQL 數據庫用於存儲用戶、API 密鑰和事務記錄。

問題排除

如果遇到依賴項問題：

# MCP SDK 問題 - 直接從 GitHub 安裝
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdk

有關數據庫連接問題，請參閱 數據庫安裝指南。

🔧 技術細節

該系統包括：

1. MCP 服務器：一個模型上下文協議服務器，將區塊鏈操作作為工具提供給 AI 助手使用。
2. Web DApp：一個 React 應用程序，提供用戶界面用於錢包連接和交易簽名。
3. 數據庫：PostgreSQL 數據庫用於存儲用戶、API 密鑰和事務記錄。
4. 緩存：Redis 用於緩存頻繁訪問的數據。

📄 許可證

本項目根據 MIT 許可證發佈 - 詳情請見 LICENSE 文件。