debank-mcp-proxy/README.md

Secure proxy client for DeBank MCP Server - connects Claude Desktop to remote DeBank MCP server

# DeBank MCP Proxy

Connect Claude Desktop to the DeBank MCP Server for cryptocurrency and DeFi data access.

## Installation

```bash
npm install -g debank-mcp-proxy
```

## Quick Setup

1. Get your API key from the server admin
2. Setup the proxy:

```bash
kaito-mcp setup --key YOUR_API_KEY
```

3. Restart Claude Desktop

## Available Commands

```bash
# Setup proxy for Claude Desktop
debank-mcp setup --key YOUR_API_KEY

# Test connection to server
debank-mcp test --key YOUR_API_KEY

# Show proxy information
debank-mcp info

# Generate new API key (server admins only)
debank-mcp generate-key
```

## Available Tools

Once connected, you can use these tools in Claude:

- `getPortfolio` - Get complete portfolio data for an address
- `getTokenBalances` - Get token balances
- `getTransactions` - Get transaction history
- `getAllowances` - Check token allowances
- `getNFTs` - Get NFT holdings
- `getProtocolPositions` - Get DeFi protocol positions

## Manual Configuration

If automatic setup doesn't work, add this to your Claude Desktop config:

```json
{
  "mcpServers": {
    "debank-mcp": {
      "command": "node",
      "args": ["path/to/debank-mcp-proxy/dist/index.js"],
      "env": {
        "DEBANK_API_KEY": "YOUR_API_KEY",
        "DEBANK_SERVER_URL": "https://debank-mcp-server.fly.dev"
      }
    }
  }
}
```

## Environment Variables

- `DEBANK_API_KEY` - Your API key for authentication (required)
- `DEBANK_SERVER_URL` - Remote server URL (default: https://debank-mcp-server.fly.dev)

## Security

- API keys are validated locally before sending to server
- All communication is over HTTPS
- Keys are never logged or exposed

## License

MIT