ChainGuard-多链区块链犯罪检测MCP服务器
ChainGuard是一款基于人工智能的MCP服务器,使Claude Desktop能够通过自然语言对话在比特币、以太坊、Hedera和Solana网络上执行实时区块链犯罪检测和取证分析。
📋 项目详细说明
ChainGuard通过模型上下文协议(MCP)将复杂的犯罪检测功能直接引入人工智能助手,从而彻底改变了区块链的安全性。这一创新解决方案解决了DeFi生态系统中对可访问区块链取证日益增长的需求。
核心创新:
- MCP集成:首创区块链犯罪检测MCP服务器
- 多链支持:跨4个主要区块链网络的统一分析
- 自然语言接口:通过简单对话进行复杂的区块链分析
- 实时检测:实时监测和分析可疑活动
技术架构:
- 基于Cloudflare Workers构建,实现全球可扩展性和低延迟
- 实现MCP流式HTTP传输协议
- 与多个区块链API(Etherscan、Helius、BlockCypher、Hedera Mirror Node)集成
- 用于犯罪检测的先进模式识别算法
- 全面的风险评分和声誉系统
使用案例:
- DeFi协议安全审计
- 加密货币交易所合规性
- 执法区块链调查
- 个人钱包安全评估
- 跨链洗钱检测
🚀 Live服务器: https://chainguard-mcp-server.ndivij2004.workers.dev/mcp
黑客马拉松焦点:MCP+DeFi自动化
该项目通过以下方式直接解决了黑客马拉松的核心主题:
- MCP集成:实现完整的模型上下文协议,实现无缝的AI助手集成
- DeFi安全:用于DeFi协议和交易的高级犯罪检测算法
- 跨链分析:多区块链支持,实现全面的安全覆盖
- 实时检测对可疑活动和模式进行实时分析
🔧 Claude桌面的快速设置
1.配置克劳德桌面
将此配置添加到您的Claude Desktop设置中(claude_desktop_config.json):
{
"mcpServers": {
"chainguard": {
"command": "npx",
"args": [
"mcp-remote",
"https://chainguard-mcp-server.ndivij2004.workers.dev/mcp"
]
}
}
}2.重新启动克劳德桌面
添加配置后,重新启动Claude Desktop。ChainGuard工具将出现在🔨 工具部分。
3.开始分析
尝试以下示例提示:
- “分析比特币地址1A1zP1eP5QDefi2DMPTfTL5SLmv7DivfNa是否存在可疑活动”
- “检查以太坊地址0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045的犯罪模式”
- “为多个地址生成全面的犯罪报告”
🛠️ 可用工具(共9个)
| 工具 | 描述 | 区块链 |
|---|---|---|
analyze_bitcoin_address 比特币犯罪检测和交易分析 | ||
analyze_ethereum_address | 以太坊地址分析和智能合约风险 | 以太坊 |
analyze_hedera_account | Hedera账户行为与共识分析 | Hedera |
analyze_solana_wallet | Solana钱包分析和代币风险检测 | Solana |
detect_rug_pull_ethereum | 以太坊智能合约地毯拉扯检测 | 以太坊 |
detect_pump_dump_solana | Solana代币泵和转储方案检测 | Solana |
analyze_cross_chain_activity | 多链可疑活动关联 | 所有链 |
generate_crime_report | 全面的法医报告 | All Chains |
check_address_reputation | 针对犯罪数据库解决声誉问题 | 所有链 |
📦 安装步骤
先决条件
- Node.js 18+
- npm或yarn包管理器
- Cloudflare帐户(用于部署)
- API密钥(可选但推荐):
- Etherscan API密钥 - Helius API密钥
安装
# 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🔐 环境变量
支持以下环境变量:
| 变量 | 描述 | 必填 | 默认 |
|---|---|---|---|
ETHERSCAN_API_KEY | 用于增强以太坊数据的Etherscan API密钥 | 否 | YourApiKeyToken |
HELIUS_API_KEY | 用于增强索拉纳数据的Helius API密钥 | 否 | demo |
BLOCKCYPHER_API_KEY | 比特币数据的BlockCypher API密钥 | 否 | 未使用 |
设置环境变量
地方发展:
# Edit .env file
ETHERSCAN_API_KEY=your_etherscan_api_key_here
HELIUS_API_KEY=your_helius_api_key_here对于生产(Cloudflare员工):
# 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部署到Cloudflare Workers
# Deploy to production
npx wrangler deploy
# Check deployment status
npx wrangler tail🔍 主要特点
多链犯罪检测
- 比特币分析:交易模式分析、混合器检测和可疑地址识别
- 以太坊安全:智能合约拉地毯检测、MEV分析、气体异常检测
- Hedera法医:账户行为分析和共识时间戳验证
- 索拉纳监测:泵和转储检测、钱包聚类和程序分析
高级检测算法
- 模式识别:基于机器学习的可疑交易模式检测
- 风险评分:加权因素综合风险评估
- 跨链关联:多区块链活动模式分析
- 实时监控:实时检测新出现的威胁和方案
💡 使用示例
基本地址分析
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 investigationDeFi安全审计
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费率限制:
- 演示API密钥每分钟的请求数有限 - 解决方案:使用您自己的API密钥进行生产使用
- 历史数据限制:
- 一些区块链API限制了历史交易深度 - 影响:旧交易可能不包括在分析中
- 跨链计时:
- 不同的区块链确认时间影响实时相关性 - 缓解措施:分析包括时间戳规范化
- 假阳性:
- 大量合法地址可能会触发风险警报 - 建议:手动审查极端活动地址
- 网络依赖关系:
- 依赖于外部区块链API(Etherscan、Helius等) - 影响:服务可用性取决于上游提供商
🔧 故障排除
常见问题
Claude Desktop未显示工具:
- 确保
mcp-remote已安装:npm install -g mcp-remote - 验证中的配置
claude_desktop_config.json - 配置更改后重新启动Claude Desktop
API错误:
- 检查API密钥设置是否正确
- 验证网络连接
- 检查API提供程序状态页
构建失败:
- 确保已安装Node.js 18+
- 清除node_modules并重新安装:
rm -rf node_modules && npm install - 检查TypeScript编译:
npm run build
🏆 黑客马拉松成就
- ✅ 完整的MCP实施:完整的模型上下文协议服务器
- ✅ 多链支持比特币,以太坊,Hedera,Solana集成
- ✅ 生产就绪:部署在具有API密钥管理的Cloudflare Workers上
- ✅ 自然语言接口:无缝集成Claude桌面
- ✅ 高级分析:复杂的犯罪检测算法
- ✅ 实时分析:实时区块链监控功能
📄 许可证
MIT许可证-有关详细信息,请参阅许可证文件
👤 项目信息
- 主要联系人:N DIVIJ(@holaworked-电报)
- 团队:独奏
- 项目标题:ChainGuard-多链区块链犯罪检测MCP服务器
