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.
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
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
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"
]
}
}
}After adding the configuration, restart Claude Desktop. The ChainGuard tools will appear under the 🔨 Tools section.
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"
| 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 |
- Node.js 18+
- npm or yarn package manager
- Cloudflare account (for deployment)
- API keys (optional but recommended):
# 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 devThe 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 |
For Local Development:
# Edit .env file
ETHERSCAN_API_KEY=your_etherscan_api_key_here
HELIUS_API_KEY=your_helius_api_key_hereFor Production (Cloudflare Workers):
# 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 production
npx wrangler deploy
# Check deployment status
npx wrangler tail- 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
- 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
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
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
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
-
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
Claude Desktop not showing tools:
- Ensure
mcp-remoteis 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
- ✅ 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
MIT License - See LICENSE file for details
- Primary Contact: N DIVIJ (@holaworked - Telegram)
- Team: Solo
- Project Title: ChainGuard - Multi-Chain Blockchain Crime Detection MCP Server