MCP区块链服务器 & DApp

一个安全的系统，使AI助手能够与区块链智能合约交互，同时确保用户保持对其私钥和交易签名的完全控制。

概述

本项目旨在解决AI与区块链集成中的一个关键挑战：允许AI助手读取区块链数据并准备交易，同时确保用户对交易签名和私钥保持独家控制权。

该系统包括：

1. MCP服务器: 一个模型上下文协议服务器，将区块链操作公开为可供AI助手使用的工具
2. Web DApp: 一个React应用程序，提供用于钱包连接和交易签名的用户界面
3. 数据库: PostgreSQL数据库，用于存储用户、API密钥和交易记录
4. 缓存: Redis，用于缓存频繁访问的数据

功能

MCP服务器功能

• 区块链数据访问: 读取余额、合约状态和其他链上数据
• 交易准备: 创建未签名的交易以供用户批准
• 多链支持: 适用于以太坊、Polygon和其他EVM兼容链
• 智能合约交互: 从受支持网络上的已验证智能合约读取数据
• 安全至上设计: 私钥永远不会离开用户的钱包

Web DApp 功能

• 钱包集成: 与MetaMask和其他Web3钱包连接
• 交易审查: 清晰的用户界面，用于在签名之前审查交易详情
• 交易签名: 使用连接的钱包签署交易
• 交易跟踪: 监控已提交交易的状态
• 移动设备兼容性: 响应式设计，适用于所有设备

安全原则

1. 私钥隔离: 密钥永远不会离开用户的钱包
2. 交易验证: 清晰的用户界面，用于审查交易详情
3. API身份验证: 安全的API密钥管理
4. 速率限制: 防止滥用
5. 输入验证: 清理所有输入
6. 审计日志: 跟踪所有操作
7. 仅HTTPS: 安全通信
8. 内容安全策略: 防止XSS

交易流程

1. AI助手通过MCP服务器请求交易
2. MCP服务器准备带有UUID的未签名交易
3. MCP服务器将交易URL返回给AI助手
4. AI助手将URL提供给用户
5. 用户在浏览器中打开URL
6. 用户连接钱包并审查交易详情
7. 用户批准并使用其钱包签署交易
8. Web DApp将已签名交易提交到区块链
9. 交易状态更新并被跟踪

快速开始

前提条件

• Node.js (v18 或更高版本)
• npm 或 yarn
• PostgreSQL
• Redis (可选，用于缓存)
• Infura API 密钥 (用于区块链访问)
• Etherscan API 密钥 (用于合约 ABI)

安装

1. 克隆存储库:

git clone https://github.com/zhangzhongnan928/mcp-blockchain-server.git
cd mcp-blockchain-server

2. 安装依赖:

npm install
# 或
yarn install

3. 设置环境变量: 在根目录中创建一个 .env 文件 (或从 .env.example 复制):

cp .env.example .env
# 使用您的配置编辑 .env

4. 设置数据库:

# 有关详细说明，请参阅数据库设置指南
# docs/database-setup.md

# 创建 PostgreSQL 数据库
createdb mcp_blockchain

# 运行数据库迁移
npm run db:migrate
# 或
yarn db:migrate

有关安装和配置 PostgreSQL 的详细说明，请参阅 数据库设置指南。

5. 启动服务器:

npm run dev
# 或
yarn dev

使用 Docker Compose

为了使用 Docker 快速启动：

# 创建包含所需环境变量的 .env 文件
cp .env.example .env
# 使用您的配置编辑 .env

# 启动服务
docker-compose up -d

这将启动：

• PostgreSQL 数据库
• Redis 缓存
• MCP 服务器
• Web DApp

开发

服务器结构

• src/mcp: MCP 服务器实现
• src/services: 核心业务逻辑服务
• src/utils: 实用函数
• src/index.ts: 主入口点

Web DApp 结构

• web/src/components: React 组件
• web/src/hooks: 自定义 React hooks
• web/src/services: API 服务
• web/src/pages: 页面组件

使用 MCP 服务器

MCP 服务器公开了几个可供 AI 助手使用的工具：

• get-chains: 获取受支持的区块链网络列表
• get-balance: 获取地址的帐户余额
• read-contract: 从智能合约读取数据
• prepare-transaction: 准备未签名的交易以供用户批准
• get-transaction-status: 获取交易的当前状态

工具使用示例

// 使用 get-balance 工具的示例
const result = await callTool("get-balance", {
  chainId: "1",
  address: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
});

故障排除

如果您遇到依赖项问题：

# MCP SDK 问题 - 直接从 GitHub 安装
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdk

对于数据库连接问题，请参阅 数据库设置指南。

许可证

本项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。