使用说明
用于区块链、人工智能自动化和网络安全的MCP服务器
一种尖端的模型上下文协议(MCP)服务器基础设施,旨在通过集成的人工智能自动化和企业级安全为下一代去中心化应用程序提供动力。
📋 目录
🌟 特性
🔗 区块链集成
- 多链支持:以太坊、Polygon、Arbitrum、乐观主义、Solana
- 跨链桥梁作业 具有实时费用估算和交易监控功能
- 智能合约审计 具有漏洞检测和气体优化功能
- NFT市场整合 使用OpenSea API和元数据管理
- 加密钱包操作 具有安全的交易签名和余额管理功能
- DeFi协议交互 风险评估
🤖 AI自动化
- 自主智能合约审计 基于模式的漏洞检测
- 基于人工智能的合规监控 跨多个框架(GDPR、HIPAA、PCI-DSS、ISO27001)
- 预测分析 用于桥梁作业和气体优化
- 自然语言处理 用于安全性和合规性查询
- 自动化风险评估 以及缓解建议
🛡️ 网络安全
- 高级网络扫描 使用Nmap集成和NSE脚本
- 实时漏洞检测 使用Shodan API
- 合规框架监控 自动间隙分析
- 渗透测试工作流程 全面报告
- 安全事件模拟 以及响应计划
- 端到端加密 OAuth 2.1身份验证
🚀 快速开始
⚡ 1分钟设置
# Clone repository
git clone https://github.com/0x-Professor/MCPServers.git
cd MCPServers
# Quick setup script (Windows)
.\scripts\quick-setup.bat
# OR Manual setup
pip install uv
uv venv && .venv\Scripts\activate
🎯 选择你的冒险
| 用例 | 服务器 | 命令 |
|---|---|---|
| 🔗 区块链开发 | 跨链桥 | cd BlockChain/cross_chain_bridge_assistant && uv run mcp dev server/server.py |
| 🎨 NFT项目 | NFT市场 | cd BlockChain/nft_marketPlace_assistant && uv run mcp dev server/server.py |
| 🔍 安全审计 | 智能合约审核员 | cd BlockChain/mcp_smart_contract_auditor && uv run mcp dev server/server.py |
| 🛡️ 网络安全 | Nmap扫描仪 | cd CyberSecurity/nmap_mcp && uv run mcp dev server/server.py |
| 📋 合规 | 合规性监视器 | cd CyberSecurity/ComplianceMCP && uv run mcp dev server/server.py |
🌐 访问您的服务器
启动后,访问 MCP检查员 在: http://localhost:3001
📖 安装指南
📋 先决条件
| 需求 | 版本 | 安装 |
|---|---|---|
| python | 3.8+ | 下载Python |
| 紫外线 | 最新消息 | pip install uv |
| Git | 最新消息 | 下载Git |
| 扫描器 | 最新消息 | 仅限Linux/WSL |
🔑 必需的API密钥
| 服务 | 目的 | 获取密钥 |
|---|---|---|
| 炼金术 | 区块链RPC | alchemy.com |
| 以太网扫描 | 交易数据 | etherscan.io/apis |
| OpenSea | NFT市场 | docs.opensea.io |
| 肖丹 | 漏洞数据 | shodan.io |
| 英富拉 | Web3提供商 | 伊芙拉.io |
💻 分步安装
1. 存储库设置
# Clone the repository
git clone https://github.com/0x-Professor/MCPServers.git
cd MCPServers
# Verify structure
ls -la
2. 环境设置
# Install uv package manager
pip install uv
# Create virtual environment
uv venv
# Activate environment
# Windows:
.venv\Scripts\activate
# Linux/macOS:
source .venv/bin/activate
3. 依赖关系安装
选择您的安装方法:
选项A:完整安装(所有服务器)
# Install all dependencies
uv add -r requirements.txt
选项B:选择性安装
# Navigate to specific server
cd BlockChain/cross_chain_bridge_assistant
# Install server-specific dependencies
uv add -r requirements.txt
4. 环境配置
创建 .env 每个服务器的文件:
区块链服务器(.env)
# Blockchain APIs
ALCHEMY_API_KEY=your_alchemy_api_key
ETHERSCAN_API_KEY=your_etherscan_api_key
INFURA_PROJECT_ID=your_infura_project_id
OPENSEA_API_KEY=your_opensea_api_key
# Security & Auth
HMAC_SECRET_KEY=your_hmac_secret_key
AUTH_ISSUER_URL=https://your-auth-server.com
JWT_SECRET_KEY=your_jwt_secret
# Database
DATABASE_URL=sqlite:///server/database.db
# Logging
LOG_LEVEL=INFO
ENVIRONMENT=development
网络安全服务器(.env)
# Security APIs
SHODAN_API_KEY=your_shodan_api_key
UNIZO_API_KEY=your_unizo_api_key
# Nmap Configuration
NMAP_PATH=/usr/bin/nmap
ALLOWED_TARGETS=127.0.0.1,scanme.nmap.org
# Compliance
COMPLIANCE_DB_URL=sqlite:///server/compliance.db
# Logging
LOG_LEVEL=DEBUG
RATE_LIMIT_PER_MINUTE=15
5. 服务器启动
开发模式(配备MCP检查员)
# Navigate to server directory
cd BlockChain/cross_chain_bridge_assistant
# Start with MCP Inspector
uv run mcp dev server/server.py
# Access at http://localhost:3001
生产模式
# Start in production
uv run mcp run server/server.py
# Or direct execution
uv run python server/server.py
📚 服务器文档
🔗 区块链服务器
1.跨链桥梁助理
📁 位置: BlockChain/cross_chain_bridge_assistant
🎯 目的:通过实时监控促进安全的跨链资产转移
⚡ 主要特点:
- 多桥支持(多边形、仲裁、乐观)
- 基于燃气优化的实时费用估算
- 使用HMAC签名执行交易
- 桥梁健康监测和分析
- 通过Etherscan跟踪历史交易
🔧 可用工具:12个工具,包括 estimate_bridge_fees, execute_bridge_transaction, get_bridge_status
NFT市场助理
📁 位置: BlockChain/nft_marketPlace_assistant
🎯 目的:完成NFT市场运营和分析
⚡ 主要特点:
- 用于市场数据的OpenSea API集成
- NFT元数据管理和验证
- 收集统计和趋势分析
- 投标、铸造和上市操作
- 用于合同元数据的Alchemy NFT API
🔧 可用工具:8个工具,包括 get_nft_metadata, list_collection_nfts, get_marketplace_stats
3.智能合约审核员
📁 位置: BlockChain/mcp_smart_contract_auditor
🎯 目的:AI驱动的智能合约安全分析
⚡ 主要特点:
- 全面的漏洞检测
- 燃气效率分析与优化
- ERC标准合规性检查
- 详细审计报告生成
- 多链智能合约支持
🔧 可用工具:10个工具,包括 analyze_contract_vulnerabilities, generate_audit_report, simulate_attacks
4.加密货币钱包
📁 位置: BlockChain/mcp-crypto-wallet
🎯 目的:加密货币钱包操作安全
⚡ 主要特点:
- 通过Web3集成实现安全的钱包操作
- 交易签名和余额管理
- 多链资产支持
- 带安全控制的HD钱包功能
🔧 可用工具:6个工具,包括 create_wallet, sign_transaction, get_balance
🛡️ 网络安全服务器
1.Nmap MCP服务器
📁 位置: CyberSecurity/nmap_mcp
🎯 目的:高级网络扫描和渗透测试
⚡ 主要特点:
- 使用Nmap进行高级网络扫描
- 用于漏洞检测的NSE脚本执行
- Shodan API实时CVE数据集成
- 全面的渗透测试工作流程
- 防火墙和IDS分析
🔧 可用工具:9个工具,包括 run_nmap_scan, analyze_vulnerabilities, generate_pentest_report
2.合规MCP
📁 位置: CyberSecurity/ComplianceMCP
🎯 目的:多框架合规性监测
⚡ 主要特点:
- 多框架合规性监控(GDPR、HIPAA、PCI-DSS、ISO27001)
- Unizo EDR和XDR集成
- 实时合规状态跟踪
- 自动差距分析和补救
- 策略管理和审计跟踪
🔧 可用工具:15个工具,包括 check_gdpr_compliance, generate_compliance_report, monitor_data_usage
🛠️ api参考
📡 常见终点
所有MCP服务器都公开标准化端点:
| 端点 | 方法 | 目的 | 示例 |
|---|---|---|---|
/tools/{tool_name} |
POST | 执行工具 | POST /tools/estimate_bridge_fees |
/resources/{resource} |
GET | 获取资源 | GET /resources/bridge_status |
/health |
GET | 健康检查 | GET /health |
/docs |
获取 | API文档 | GET /docs |
🔐 认证
OAuth 2.1示例:
curl -H "Authorization: Bearer your-token" \
-H "Content-Type: application/json" \
-X POST http://localhost:3001/tools/estimate_bridge_fees \
-d '{
"source_chain": "ethereum",
"destination_chain": "polygon",
"asset": "ETH",
"amount": "1.0"
}'
API关键示例:
curl -H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-X POST http://localhost:3001/tools/run_nmap_scan \
-d '{
"target": "scanme.nmap.org",
"scan_type": "-sS"
}'
📊 响应格式
所有回复均遵循一致的格式:
{
"status": "success|error",
"data": {
// Tool-specific response data
},
"metadata": {
"timestamp": "2025-07-29T12:00:00Z",
"execution_time": 1.23,
"server": "cross_chain_bridge_assistant",
"version": "1.0.0"
},
"errors": [] // Present only on error
}
🏗️ 建筑
graph TD
A[Client Applications] -->|MCP Protocol| B[MCP Gateway]
B --> C[Blockchain Module]
B --> D[AI/Compliance Engine]
B --> E[Security Layer]
C --> F[Cross-Chain Bridge]
C --> G[NFT Marketplace]
C --> H[Smart Contract Auditor]
C --> I[Crypto Wallet]
D --> J[Compliance Monitor]
D --> K[Risk Assessment]
E --> L[Nmap Scanner]
E --> M[Vulnerability Detection]
E --> N[Threat Intelligence]
F --> O[Ethereum/Polygon/Arbitrum]
G --> P[OpenSea API]
H --> Q[Multiple Chains]
J --> R[GDPR/HIPAA/PCI-DSS]
L --> S[Network Infrastructure]
🔧 配置
🌍 环境变量
全局配置:
# Application
ENVIRONMENT=development|staging|production
LOG_LEVEL=DEBUG|INFO|WARNING|ERROR
DEBUG=true|false
# Security
RATE_LIMIT_PER_MINUTE=15
SESSION_TIMEOUT=3600
CORS_ORIGINS=http://localhost:3001
# Database
DATABASE_URL=sqlite:///server/database.db
DB_POOL_SIZE=5
DB_TIMEOUT=30
# Authentication
JWT_SECRET_KEY=your-secret-key
JWT_ALGORITHM=HS256
JWT_EXPIRATION=3600
⚙️ 服务器特定配置
每台服务器都支持中的自定义设置 config.py:
# Example: Cross-Chain Bridge configuration
BRIDGE_CONFIG = {
"supported_chains": {
"ethereum": {
"rpc_url": "https://eth-mainnet.g.alchemy.com/v2/{API_KEY}",
"chain_id": 1,
"gas_limit": 21000
},
"polygon": {
"rpc_url": "https://polygon-mainnet.g.alchemy.com/v2/{API_KEY}",
"chain_id": 137,
"gas_limit": 21000
}
},
"bridge_contracts": {
"polygon_bridge": "0x...",
"arbitrum_bridge": "0x..."
},
"fee_estimation": {
"slippage_tolerance": 0.01,
"gas_price_multiplier": 1.1
}
}
🧪 测试
🔬 MCP检验员测试
启动开发服务器:
uv run mcp dev server/server.py
访问Web界面: http://localhost:3001
交互式测试功能:
- 实时工具执行
- 请求/响应检查
- 架构验证
- 性能监控
🛠️ 命令行测试
桥梁运营:
# Test bridge fee estimation
curl -X POST http://localhost:3001/tools/estimate_bridge_fees \
-H "Content-Type: application/json" \
-d '{
"source_chain": "ethereum",
"destination_chain": "polygon",
"asset": "ETH",
"amount": "1.0"
}'
安全扫描:
# Test Nmap scan
curl -X POST http://localhost:3001/tools/run_nmap_scan \
-H "Content-Type: application/json" \
-d '{
"target": "scanme.nmap.org",
"scan_type": "-sS",
"ports": "1-1000"
}'
NFT操作:
# Test NFT metadata retrieval
curl -X POST http://localhost:3001/tools/get_nft_metadata \
-H "Content-Type: application/json" \
-d '{
"contract_address": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
"token_id": "1"
}'
🧪 自动化测试
运行测试套件:
# All tests
uv run pytest
# Specific server tests
uv run pytest tests/blockchain/test_bridge.py
# With coverage
uv run pytest --cov=src --cov-report=html
# Security tests
uv run pytest tests/security/ -v
🔒 安全
🛡️ 安全功能
- 输入验证:全面的Pydantic模型验证
- 速率限制:每个IP每分钟15个请求(可配置)
- 认证:OAuth 2.1支持基于范围的访问控制
- 加密:敏感操作的HMAC签名
- 审计日志:SQLite数据库中的完整操作跟踪
- 安全默认值:限制命令执行和分配操作
🚨 安全指南
对于贡献者:参见 安全.md 用于:
- 漏洞报告程序
- 安全审查流程
- 负责任的披露指南
- 安全测试要求
对于用户:
- 在生产环境中始终使用HTTPS
- 定期旋转API键
- 监控审核日志
- 保持依赖关系更新
📊 按服务器列出的功能
| 服务器 | 工具 | 资源 | 身份验证 | 数据库 | 安全级别 |
|---|---|---|---|---|---|
| 跨链桥 | 12 | 5 | OAuth 2.1 | SQLite | 🔴 关键 |
| NFT市场 | 8 | 4 | OAuth 2.1 | SQLite | 🟡 高 |
| 智能合约审计员 | 10 | 3 | 可选 | 内存 | 🟡 高 |
| 加密钱包 | 6 | 2 | 必需 | 内存 | 🔴 关键 |
| Nmap扫描器 | 9 | 2 | OAuth 2.1 | SQLite | 🟠 中等 |
| 合规性监视器 | 15 | 8 | 可选 | SQLite | 🟡 高 |
🚨 法律与合规
⚖️ 重要通知
- 网络扫描:只有您拥有或明确允许测试的扫描系统
- API使用:遵守外部API的费率限制和服务条款
- 数据保护:对敏感数据处理实施适当的控制
- 合规:确保运营符合您所在司法管辖区的要求
- 资产运营:区块链操作涉及财务风险-谨慎使用
📋 合规性特征
- GDPR 数据保护:数据保护和隐私控制
- 健康保险流通与责任法案:医疗数据安全(如适用)
- PCI-DSS:支付卡行业合规性
- ISO 27001:信息安全管理
- SOC 2:安全和可用性控制
🤝 贡献
我们欢迎捐款!以下是如何开始:
🚀 快速贡献指南
- 阅读指南:检查 贡献.md
- 遵守行为准则:评论 代码_OF_CONDUCT.md
- 分叉与克隆:准备好您的开发环境
- 创建特征分支:
git checkout -b feature/amazing-feature - 进行更改:遵循我们的编码标准
- 彻底测试:确保所有测试通过
- 提交PR:创建详细的拉取请求
📏 开发标准
- 代码的风格:黑色格式,行长88个字符
- 类型提示:所有功能都需要
- 文档:全面的文档和评论
- 测试:新代码的最低覆盖率为80%
- 安全:所有PR都经过安全审查
🎖️ 识别级别
- 🥉 青铜:1-5个合并的PR
- 🥈 银:6-15个合并的PR或重要特征
- 🥇 黄金:16+合并PR或重大建筑贡献
- 💎 钻石:长期维护者身份
📄 许可证
该项目根据麻省理工学院许可证获得许可,并附有网络安全和区块链组件的附加免责声明-请参阅 许可证 文件以获取详细信息。
🔒 附加免责声明
- 网络安全工具:仅用于授权测试
- 区块链运营:教育/发展目的
- 财务风险:用户承担所有与区块链相关的风险
- 遵守法律:负责监管合规的用户
🌐 社区
加入我们不断壮大的社区:
💬 沟通渠道
- GitHub讨论: 一般问答和功能请求
- 问题: Bug报告和技术问题
- 安全: mr.mazharsaeed790@gmail.com 安全问题
- Discord 的中文翻译是“不和谐”或“纷争”。:社区聊天(即将推出)
- 推特:项目更新(即将推出)
📈 项目统计
- 服务器:6台生产就绪的MCP服务器
- 工具:60多种区块链和网络安全工具
- 语言:Python 3.8+,完全支持异步
- 依赖项:精心策划和安全扫描
- 测试:全面的测试套件,覆盖率超过85%
🔍 路线图
✅ 完成
- [x] 核心MCP服务器实现
- [x] 跨链桥梁作业
- [x] NFT市场整合
- [x] 智能合约审计功能
- [x] 高级网络扫描工具
- [x] 合规性监测框架
- [x] 全面的文件
- [x] 安全政策和治理
🚀 进行中
- []增强的人工智能安全分析
- []实时威胁情报集成
- []性能优化和缓存
- []高级身份验证功能
🔮 未来计划
- []其他区块链网络(Solana、Avalanche、Cosmos)
- []去中心化身份集成
- []多租户架构
- []Kubernetes部署图表
- []移动SDK开发
- []企业仪表板
- []漏洞赏金计划启动
🙏 致谢
特别感谢:
- 模型上下文协议 -对于基础协议规范
- FastMCP -优秀的Python SDK
- 开源社区 -感谢为这个项目提供动力的神奇工具和库
- 安全研究人员 -负责披露和安全改进
- 贡献者 -为了让这个项目每天都变得更好
- 用户 -感谢您将您的区块链和安全操作托付给我们
🏆 名人堂
核心贡献者:
- 穆罕默德·马扎尔·赛义德(教授) -项目创始人兼首席架构师
- 你的名字可能在这里!今天贡献。
由以下材料制成❤️ 穆罕默德·马扎尔·赛义德教授
利用人工智能驱动的自动化和企业级安全性构建去中心化应用程序的未来。
⭐ 如果你觉得这个存储库有用,请为其加星!