ChainGuard - Multi-Chain Blockchain Crime Detection MCP Server

ChainGuard is an AI-powered MCP server that enables Claude Desktop to perform real-time blockchain crime detection and forensic analysis across Bitcoin, Ethereum, Hedera, and Solana networks through natural language conversations.

📋 Detailed Project Description

ChainGuard revolutionizes blockchain security by bringing sophisticated crime detection capabilities directly into AI assistants through the Model Context Protocol (MCP). This innovative solution addresses the growing need for accessible blockchain forensics in the DeFi ecosystem.

Core Innovation:

MCP Integration: First-of-its-kind blockchain crime detection MCP server
Multi-Chain Support: Unified analysis across 4 major blockchain networks
Natural Language Interface: Complex blockchain analysis through simple conversations
Real-Time Detection: Live monitoring and analysis of suspicious activities

Technical Architecture:

Built on Cloudflare Workers for global scalability and low latency
Implements MCP Streamable HTTP transport protocol
Integrates with multiple blockchain APIs (Etherscan, Helius, BlockCypher, Hedera Mirror Node)
Advanced pattern recognition algorithms for crime detection
Comprehensive risk scoring and reputation systems

Use Cases:

DeFi protocol security auditing
Cryptocurrency exchange compliance
Law enforcement blockchain investigations
Individual wallet security assessment
Cross-chain money laundering detection

🚀 Live Server: https://chainguard-mcp-server.ndivij2004.workers.dev/mcp

Hackathon Focus: MCPs + DeFi Automation

This project directly addresses the hackathon's core theme by:

MCP Integration: Full Model Context Protocol implementation for seamless AI assistant integration
DeFi Security: Advanced crime detection algorithms for DeFi protocols and transactions
Cross-Chain Analysis: Multi-blockchain support for comprehensive security coverage
Real-Time Detection: Live analysis of suspicious activities and patterns

🔧 Quick Setup for Claude Desktop

1. Configure Claude Desktop

Add this configuration to your Claude Desktop settings (claude_desktop_config.json):

{
  "mcpServers": {
    "chainguard": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://chainguard-mcp-server.ndivij2004.workers.dev/mcp"
      ]
    }
  }
}

2. Restart Claude Desktop

After adding the configuration, restart Claude Desktop. The ChainGuard tools will appear under the 🔨 Tools section.

3. Start Analyzing

Try these example prompts:

"Analyze Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa for suspicious activity"
"Check Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 for crime patterns"
"Generate a comprehensive crime report for multiple addresses"

🛠️ Available Tools (9 Total)

| Tool | Description | Blockchain | |------|-------------|------------| | analyze_bitcoin_address | Bitcoin crime detection and transaction analysis | Bitcoin | | analyze_ethereum_address | Ethereum address analysis and smart contract risks | Ethereum | | analyze_hedera_account | Hedera account behavior and consensus analysis | Hedera | | analyze_solana_wallet | Solana wallet analysis and token risk detection | Solana | | detect_rug_pull_ethereum | Ethereum smart contract rug pull detection | Ethereum | | detect_pump_dump_solana | Solana token pump & dump scheme detection | Solana | | analyze_cross_chain_activity | Multi-chain suspicious activity correlation | All Chains | | generate_crime_report | Comprehensive forensic reports | All Chains | | check_address_reputation | Address reputation against crime databases | All Chains |

📦 Install Steps

Prerequisites

Node.js 18+
npm or yarn package manager
Cloudflare account (for deployment)
API keys (optional but recommended):
Etherscan API Key
Helius API Key

Installation

# 1. Clone the repository
git clone https://github.com/ndivij2004/MessariMCP.git
cd MessariMCP

# 2. Install dependencies
npm install

# 3. Copy environment variables template
cp .env.example .env

# 4. Build the project
npm run build

# 5. (Optional) Run locally for testing
npx wrangler dev

🔐 Environment Variables

The following environment variables are supported:

| Variable | Description | Required | Default | |----------|-------------|----------|---------| | ETHERSCAN_API_KEY | Etherscan API key for enhanced Ethereum data | No | YourApiKeyToken | | HELIUS_API_KEY | Helius API key for enhanced Solana data | No | demo | | BLOCKCYPHER_API_KEY | BlockCypher API key for Bitcoin data | No | Not used |

Setting Environment Variables

For Local Development: ```bash

Edit .env file

ETHERSCAN_API_KEY=your_etherscan_api_key_here HELIUS_API_KEY=your_helius_api_key_here ```

For Production (Cloudflare Workers): ```bash

Set secrets for production deployment

npx wrangler secret put ETHERSCAN_API_KEY npx wrangler secret put HELIUS_API_KEY

Verify secrets are set

npx wrangler secret list ```

Deploy to Cloudflare Workers

# Deploy to production
npx wrangler deploy

# Check deployment status
npx wrangler tail

🔍 Key Features

Multi-Chain Crime Detection

Bitcoin Analysis: Transaction pattern analysis, mixer detection, and suspicious address identification
Ethereum Security: Smart contract rug pull detection, MEV analysis, and gas anomaly detection
Hedera Forensics: Account behavior analysis and consensus timestamp verification
Solana Monitoring: Pump & dump detection, wallet clustering, and program analysis

Advanced Detection Algorithms

Pattern Recognition: ML-powered detection of suspicious transaction patterns
Risk Scoring: Comprehensive risk assessment with weighted factors
Cross-Chain Correlation: Multi-blockchain activity pattern analysis
Real-Time Monitoring: Live detection of emerging threats and schemes

💡 Usage Examples

Basic Address Analysis

User: "Analyze Bitcoin address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa for suspicious activity"

ChainGuard Response:
- Transaction count: 1,000+
- Risk score: 15/100 (Low risk)
- Notable patterns: Genesis block address, high historical significance
- Recommendations: No suspicious activity detected

Multi-Chain Investigation

User: "Generate a comprehensive crime report for these addresses: 
- Bitcoin: 1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2
- Ethereum: 0x742d35Cc6634C0532925a3b8D4C9db4C7b5d8B3E"

ChainGuard Response:
- Cross-chain risk score: 75/100 (High risk)
- Suspicious patterns detected across both chains
- Timing correlations found in transaction patterns
- Recommended for further investigation

DeFi Security Audit

User: "Check Ethereum contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 for rug pull risks"

ChainGuard Response:
- Contract verification: ✅ Verified source code
- Ownership analysis: Decentralized governance
- Liquidity risks: Low
- Overall assessment: Safe for interaction

⚠️ Known Issues

API Rate Limits:

Demo API keys have limited requests per minute
Solution: Use your own API keys for production usage

Historical Data Limitations:

Some blockchain APIs limit historical transaction depth
Impact: Older transactions may not be included in analysis

Cross-Chain Timing:

Different blockchain confirmation times affect real-time correlation
Mitigation: Analysis includes timestamp normalization

False Positives:

High-volume legitimate addresses may trigger risk alerts
Recommendation: Manual review for addresses with extreme activity

Network Dependencies:

Relies on external blockchain APIs (Etherscan, Helius, etc.)
Impact: Service availability depends on upstream providers

🔧 Troubleshooting

Common Issues

Claude Desktop not showing tools:

Ensure mcp-remote is installed: npm install -g mcp-remote
Verify configuration in claude_desktop_config.json
Restart Claude Desktop after configuration changes

API errors:

Check if API keys are properly set
Verify network connectivity
Check API provider status pages

Build failures:

Ensure Node.js 18+ is installed
Clear node_modules and reinstall: rm -rf node_modules && npm install
Check TypeScript compilation: npm run build

🏆 Hackathon Achievements

✅ Full MCP Implementation: Complete Model Context Protocol server
✅ Multi-Chain Support: Bitcoin, Ethereum, Hedera, Solana integration
✅ Production Ready: Deployed on Cloudflare Workers with API key management
✅ Natural Language Interface: Seamless Claude Desktop integration
✅ Advanced Analytics: Sophisticated crime detection algorithms
✅ Real-Time Analysis: Live blockchain monitoring capabilities

📄 License

MIT License - See LICENSE file for details

👤 Project Information

Primary Contact: N DIVIJ (@holaworked - Telegram)
Team: Solo
Project Title: ChainGuard - Multi-Chain Blockchain Crime Detection MCP Server

ChainGuard