Blockchain Signer

🚀 MCP Blockchain Server & DApp

A security system that enables AI assistants to interact with blockchain smart contracts while ensuring users have full control over their private keys and transaction signatures.

🚀 Quick Start

This project addresses a crucial challenge in the integration of AI and blockchain: enabling AI assistants to read blockchain data and prepare transactions while ensuring users have exclusive control over transaction signatures and private keys.

✨ Features

MCP Server Features

• Blockchain Data Access: Read balances, contract statuses, and other on-chain data.
• Transaction Preparation: Create unsigned transactions pending user approval.
• Multi-chain Support: Compatible with Ethereum, Polygon, and other EVM-compatible chains.
• Smart Contract Interaction: Read from verified smart contracts on supported networks.
• Security-first Design: Private keys never leave the user's wallet.

Web DApp Features

• Wallet Integration: Connect with MetaMask and other Web3 wallets.
• Transaction Review: A clear user interface for viewing transaction details before signing.
• Transaction Signing: Sign transactions using the connected wallet.
• Transaction Tracking: Monitor the status of submitted transactions.
• Mobile Compatibility: Responsive design for all devices.

🔧 Technical Details

Security Principles

1. Private Key Isolation: Keys never leave the user's wallet.
2. Transaction Verification: A clear user interface for reviewing transaction details.
3. API Authentication: Secure API key management.
4. Rate Limiting: Prevent abuse.
5. Caching: Redis is used to cache frequently accessed data.
6. Database: A PostgreSQL database is used to store users, API keys, and transaction records.

System Components

• MCP Server: A Model Context Protocol server that provides blockchain operations as tools for AI assistants.
• Web DApp: A React application that provides a user interface for wallet connection and transaction signing.
• Database: A PostgreSQL database for storing users, API keys, and transaction records.
• Cache: Redis for caching frequently accessed data.

📦 Installation

To install the project:

# Install dependencies using npm
npm install

# Start the development server
npm run dev

# Build the production version
npm run build

💻 Usage Examples

Troubleshooting

If you encounter dependency issues:

# MCP SDK issue - Install directly from GitHub
npm uninstall @modelcontextprotocol/sdk
npm install modelcontextprotocol/typescript-sdk

For database connection issues, refer to the Database Setup Guide.

📄 License

This project is released under the MIT License - see the LICENSE file for details.