🚀 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 文件。