🚀 MCP 区块链服务器 & DApp
本项目是一个安全系统,允许 AI 助手与区块链智能合约进行交互。同时,它能确保用户完全掌控自己的私钥和交易签名,有效解决了 AI 与区块链集成过程中的关键难题。
🚀 快速开始
若要安装项目:
npm install
npm run dev
npm run build
✨ 主要特性
MCP 服务器功能
- 区块链数据访问:可读取余额、合同状态和其他链上数据。
- 交易准备:能够创建待用户批准的未签名交易。
- 多链支持:适用于以太坊(Ethereum)、Polygon 及其他 EVM 兼容链。
- 智能合约交互:可从受支持网络上的已验证智能合约中读取数据。
- 安全优先设计:私钥永远不会离开用户的钱包。
Web DApp 功能
- 钱包集成:可与 MetaMask 等其他 Web3 钱包进行连接。
- 交易审查:拥有清晰的用户界面,方便用户在签名前查看交易细节。
- 交易签名:支持使用连接的钱包签署交易。
- 交易跟踪:可监控已提交事务的状态。
- 移动兼容性:采用响应式设计,适用于所有设备。
📦 安装指南
依赖安装
npm install
启动开发服务器
npm run dev
构建生产版本
npm run build
问题排除
如果遇到依赖项问题:
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdk
有关数据库连接问题,请参阅 数据库安装指南。
📚 详细文档
概述
本项目解决了 AI 与区块链集成中的关键挑战:让 AI 助手读取区块链数据并准备交易,同时保证用户对交易签名和私钥拥有独家控制权。
该系统包括:
- MCP 服务器:一个模型上下文协议服务器,将区块链操作作为工具提供给 AI 助手使用。
- Web DApp:一个 React 应用程序,提供用户界面用于钱包连接和交易签名。
- 数据库:PostgreSQL 数据库用于存储用户、API 密钥和事务记录。
- 缓存:Redis 用于缓存频繁访问的数据。
安全原则
- 私钥隔离:密钥永远不会离开用户的钱包。
- 交易验证:清晰的用户界面用于审查交易细节。
- API 认证:安全的 API 密钥管理。
- 速率限制:防止滥用。
- 缓存:Redis 用于缓存频繁访问的数据。
- 数据库:PostgreSQL 数据库用于存储用户、API 密钥和事务记录。
📄 许可证
本项目根据 MIT 许可证发布 - 详情请见 LICENSE 文件。