READMEmaster

MCP Wallet

⚠️ WARNING: This is an experimental project. DO NOT use in production environments. Please manage your API keys and private keys securely.

A modern web application that integrates Model Context Protocol (MCP) with cryptocurrency wallet management, providing a seamless interface for AI-assisted crypto operations.

Features

Cryptocurrency Wallet Integration: Connect popular wallets using Wagmi and ethers.js
AI-Powered Assistant: Integrated MCP client for AI-driven interactions
Conversational Interface: Chat with the AI assistant to perform crypto operations
Connect-Wallet Tool: AI can help users connect their wallets through natural language
Real-time Diagnostics: System status monitoring with collapsible diagnostic panel
Server Rebuilding: One-click MCP server rebuilding for easy recovery

Technology Stack

Frontend: Next.js 14 App Router, React, TypeScript, Tailwind CSS
UI Components: Shadcn UI, Radix UI
Wallet Integration: Wagmi, ethers.js
AI Integration: Model Context Protocol (MCP), Anthropic Claude API
Styling: Tailwind CSS

Getting Started

Prerequisites

Node.js 18.x or higher
pnpm (recommended) or npm
Anthropic API key

Installation

Clone the repository:

git clone https://github.com/vlyl/mcp-wallet.git
cd mcp-wallet

Install dependencies:
```
pnpm install
```

Create a .env.local file in the root directory with the following variables:

NEXT_PUBLIC_WC_PROJECT_ID=your_wallet_connect_project_id
NEXT_TELEMETRY_DISABLED=1
ANTHROPIC_API_KEY=your_anthropic_api_key

Build the MCP server:
```
pnpm build:mcp-server
```
Start the development server:
```
pnpm dev
```
Open http://localhost:3000 in your browser.

Usage

Connect Your Wallet: Use the wallet connection panel to connect your crypto wallet
Interact with AI: Use the chat interface to ask questions or perform operations
Check System Status: Expand the MCP Diagnosis panel to view system status
Example Commands:
- "Connect my wallet with address 0x..."
- "What can I do with this wallet?"
- "Tell me about the current network"

Development

Project Structure

├── build/              # MCP server build output
├── public/             # Static assets
├── src/
│   ├── app/            # Next.js App Router files
│   │   ├── api/        # API routes
│   │   └── ...
│   ├── components/     # React components
│   │   ├── ui/         # Shadcn UI components
│   │   └── ...
│   ├── mcp/            # MCP server implementation
│   ├── services/       # Service modules
│   └── ...
└── ...

Key Components

WalletConnect: Handles wallet connection using Wagmi
ChatBox: Provides the conversational interface
McpStatus: Displays system diagnostics
MCP Services: Handles communication with the MCP server

Building for Production

Build the Next.js application:
```
pnpm build
```
Start the production server:
```
pnpm start
```

Troubleshooting

If you encounter issues with the MCP server:

Check the MCP Diagnosis panel for specific error messages
Ensure your Anthropic API key is valid and has sufficient credits
Try rebuilding the MCP server using the "Rebuild MCP Server" button
Check the console logs for more detailed error information

License

MIT

mcp-wallet