Dark Mode

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Sign up
Appearance settings

0x-Professor/MCPServers

Repository files navigation

MCP Servers for Blockchain, AI Automation & Cybersecurity

A cutting-edge Model Context Protocol (MCP) server infrastructure designed to power the next generation of decentralized applications with integrated AI automation and enterprise-grade security.

Table of Contents

  • Features
  • Quick Start
  • Installation Guide
  • Server Documentation
  • API Reference
  • Configuration
  • Testing
  • Security
  • Contributing
  • Community
  • License

Features

Blockchain Integration

  • Multi-chain support: Ethereum, Polygon, Arbitrum, Optimism, Solana
  • Cross-chain bridge operations with real-time fee estimation and transaction monitoring
  • Smart contract auditing with vulnerability detection and gas optimization
  • NFT marketplace integration with OpenSea API and metadata management
  • Crypto wallet operations with secure transaction signing and balance management
  • DeFi protocol interactions and risk assessment

AI Automation

  • Autonomous smart contract auditing with pattern-based vulnerability detection
  • AI-powered compliance monitoring across multiple frameworks (GDPR, HIPAA, PCI-DSS, ISO27001)
  • Predictive analytics for bridge operations and gas optimization
  • Natural language processing for security and compliance queries
  • Automated risk assessment and mitigation recommendations

Cybersecurity

  • Advanced network scanning with Nmap integration and NSE scripts
  • Real-time vulnerability detection using Shodan API
  • Compliance framework monitoring with automated gap analysis
  • Penetration testing workflows with comprehensive reporting
  • Security incident simulation and response planning
  • End-to-end encryption and OAuth 2.1 authentication

Quick Start

1-Minute Setup

# 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

Choose Your Adventure

Use Case Server Command
Blockchain Dev Cross-Chain Bridge cd BlockChain/cross_chain_bridge_assistant && uv run mcp dev server/server.py
NFT Projects NFT Marketplace cd BlockChain/nft_marketPlace_assistant && uv run mcp dev server/server.py
Security Audit Smart Contract Auditor cd BlockChain/mcp_smart_contract_auditor && uv run mcp dev server/server.py
Cybersecurity Nmap Scanner cd CyberSecurity/nmap_mcp && uv run mcp dev server/server.py
Compliance Compliance Monitor cd CyberSecurity/ComplianceMCP && uv run mcp dev server/server.py

Access Your Server

Once started, access the MCP Inspector at: http://localhost:3001

Installation Guide

Prerequisites

Requirement Version Installation
Python 3.8+ Download Python
uv Latest pip install uv
Git Latest Download Git
Nmap Latest Linux/WSL only

Required API Keys

Service Purpose Get Key
Alchemy Blockchain RPC alchemy.com
Etherscan Transaction data etherscan.io/apis
OpenSea NFT marketplace docs.opensea.io
Shodan Vulnerability data shodan.io
Infura Web3 provider infura.io

Step-by-Step Installation

1. Repository Setup

# Clone the repository
git clone https://github.com/0x-Professor/MCPServers.git
cd MCPServers

# Verify structure
ls -la

2. Environment Setup

# 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. Dependencies Installation

Choose your installation method:

Option A: Full Installation (All Servers)

# Install all dependencies
uv add -r requirements.txt

Option B: Selective Installation

# Navigate to specific server
cd BlockChain/cross_chain_bridge_assistant

# Install server-specific dependencies
uv add -r requirements.txt

4. Environment Configuration

Create .env files for each server:

Blockchain Servers (.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

Cybersecurity Servers (.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. Server Launch

Development Mode (with MCP Inspector)

# 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

Production Mode

# Start in production
uv run mcp run server/server.py

# Or direct execution
uv run python server/server.py

Server Documentation

Blockchain Servers

1. Cross-Chain Bridge Assistant

Location: BlockChain/cross_chain_bridge_assistant

Purpose: Facilitate secure cross-chain asset transfers with real-time monitoring

Key Features:

  • Multi-bridge support (Polygon, Arbitrum, Optimism)
  • Real-time fee estimation with gas optimization
  • Transaction execution with HMAC signatures
  • Bridge health monitoring and analytics
  • Historical transaction tracking via Etherscan

Tools Available: 12 tools including estimate_bridge_fees, execute_bridge_transaction, get_bridge_status

2. NFT Marketplace Assistant

Location: BlockChain/nft_marketPlace_assistant

Purpose: Complete NFT marketplace operations and analytics

Key Features:

  • OpenSea API integration for marketplace data
  • NFT metadata management and validation
  • Collection statistics and trend analysis
  • Bidding, minting, and listing operations
  • Alchemy NFT API for contract metadata

Tools Available: 8 tools including get_nft_metadata, list_collection_nfts, get_marketplace_stats

3. Smart Contract Auditor

Location: BlockChain/mcp_smart_contract_auditor

Purpose: AI-powered smart contract security analysis

Key Features:

  • Comprehensive vulnerability detection
  • Gas efficiency analysis and optimization
  • ERC standard compliance checking
  • Detailed audit report generation
  • Multi-chain smart contract support

Tools Available: 10 tools including analyze_contract_vulnerabilities, generate_audit_report, simulate_attacks

4. Crypto Wallet

Location: BlockChain/mcp-crypto-wallet

Purpose: Secure cryptocurrency wallet operations

Key Features:

  • Secure wallet operations with Web3 integration
  • Transaction signing and balance management
  • Multi-chain asset support
  • HD wallet features with security controls

Tools Available: 6 tools including create_wallet, sign_transaction, get_balance

Cybersecurity Servers

1. Nmap MCP Server

Location: CyberSecurity/nmap_mcp

Purpose: Advanced network scanning and penetration testing

Key Features:

  • Advanced network scanning with Nmap
  • NSE script execution for vulnerability detection
  • Shodan API integration for real-time CVE data
  • Comprehensive penetration testing workflows
  • Firewall and IDS analysis

Tools Available: 9 tools including run_nmap_scan, analyze_vulnerabilities, generate_pentest_report

2. Compliance MCP

Location: CyberSecurity/ComplianceMCP

Purpose: Multi-framework compliance monitoring

Key Features:

  • Multi-framework compliance monitoring (GDPR, HIPAA, PCI-DSS, ISO27001)
  • Unizo EDR & XDR integration
  • Real-time compliance status tracking
  • Automated gap analysis and remediation
  • Policy management and audit trails

Tools Available: 15 tools including check_gdpr_compliance, generate_compliance_report, monitor_data_usage

API Reference

Common Endpoints

All MCP servers expose standardized endpoints:

Endpoint Method Purpose Example
/tools/{tool_name} POST Execute tool POST /tools/estimate_bridge_fees
/resources/{resource} GET Get resource GET /resources/bridge_status
/health GET Health check GET /health
/docs GET API documentation GET /docs

Authentication

OAuth 2.1 Example:

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 Key Example:

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"
}'

Response Format

All responses follow a consistent format:

{
"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
}

Architecture

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]
Loading

Configuration

Environment Variables

Global Configuration:

# 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

Server-Specific Configuration

Each server supports customizable settings in 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
}
}

Testing

MCP Inspector Testing

Start Development Server:

uv run mcp dev server/server.py

Access Web Interface: http://localhost:3001

Interactive Testing Features:

  • Real-time tool execution
  • Request/response inspection
  • Schema validation
  • Performance monitoring

Command Line Testing

Bridge Operations:

# 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"
}'

Security Scanning:

# 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 Operations:

# 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"
}'

Automated Testing

Run Test Suite:

# 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

Security

Security Features

  • Input Validation: Comprehensive Pydantic model validation
  • Rate Limiting: 15 requests/minute per IP (configurable)
  • Authentication: OAuth 2.1 support with scope-based access control
  • Encryption: HMAC signatures for sensitive operations
  • Audit Logging: Complete operation trails in SQLite databases
  • Secure Defaults: Restricted command execution and allowlisted operations

Security Guidelines

For Contributors: See SECURITY.md for:

  • Vulnerability reporting procedures
  • Security review process
  • Responsible disclosure guidelines
  • Security testing requirements

For Users:

  • Always use HTTPS in production
  • Rotate API keys regularly
  • Monitor audit logs
  • Keep dependencies updated

Features by Server

Server Tools Resources Authentication Database Security Level
Cross-Chain Bridge 12 5 OAuth 2.1 SQLite Critical
NFT Marketplace 8 4 OAuth 2.1 SQLite High
Smart Contract Auditor 10 3 Optional Memory High
Crypto Wallet 6 2 Required Memory Critical
Nmap Scanner 9 2 OAuth 2.1 SQLite Medium
Compliance Monitor 15 8 Optional SQLite High

Legal & Compliance

Important Notices

  • Network Scanning: Only scan systems you own or have explicit permission to test
  • API Usage: Respect rate limits and terms of service for external APIs
  • Data Protection: Implement appropriate controls for sensitive data processing
  • Regulatory Compliance: Ensure operations meet your jurisdiction's requirements
  • Financial Operations: Blockchain operations involve financial risk - use with caution

Compliance Features

  • GDPR: Data protection and privacy controls
  • HIPAA: Healthcare data security (where applicable)
  • PCI-DSS: Payment card industry compliance
  • ISO 27001: Information security management
  • SOC 2: Security and availability controls

Contributing

We welcome contributions! Here's how to get started:

Quick Contribution Guide

  1. Read the Guidelines: Check CONTRIBUTING.md
  2. Follow Code of Conduct: Review CODE_OF_CONDUCT.md
  3. Fork & Clone: Get your development environment ready
  4. Create Feature Branch: git checkout -b feature/amazing-feature
  5. Make Changes: Follow our coding standards
  6. Test Thoroughly: Ensure all tests pass
  7. Submit PR: Create a detailed pull request

Development Standards

  • Code Style: Black formatting with 88-character line length
  • Type Hints: Required for all functions
  • Documentation: Comprehensive docstrings and comments
  • Testing: Minimum 80% coverage for new code
  • Security: All PRs undergo security review

Recognition Levels

  • Bronze: 1-5 merged PRs
  • Silver: 6-15 merged PRs or significant feature
  • Gold: 16+ merged PRs or major architectural contribution
  • Diamond: Long-term maintainer status

License

This project is licensed under the MIT License with additional disclaimers for cybersecurity and blockchain components - see the LICENSE file for details.

Additional Disclaimers

  • Cybersecurity Tools: For authorized testing only
  • Blockchain Operations: Educational/development purposes
  • Financial Risk: Users assume all blockchain-related risks
  • Legal Compliance: Users responsible for regulatory compliance

Community

Join our growing community:

Communication Channels

Project Stats

  • Servers: 6 production-ready MCP servers
  • Tools: 60+ blockchain and cybersecurity tools
  • Languages: Python 3.8+ with full async support
  • Dependencies: Carefully curated and security-scanned
  • Testing: Comprehensive test suite with 85%+ coverage

Roadmap

Completed

  • Core MCP server implementation
  • Cross-chain bridge operations
  • NFT marketplace integration
  • Smart contract auditing capabilities
  • Advanced network scanning tools
  • Compliance monitoring framework
  • Comprehensive documentation
  • Security policy and governance

In Progress

  • Enhanced AI-powered security analysis
  • Real-time threat intelligence integration
  • Performance optimization and caching
  • Advanced authentication features

Future Plans

  • Additional blockchain networks (Solana, Avalanche, Cosmos)
  • Decentralized identity integration
  • Multi-tenant architecture
  • Kubernetes deployment charts
  • Mobile SDK development
  • Enterprise dashboard
  • Bug bounty program launch

Acknowledgments

Special thanks to:

  • Model Context Protocol - For the foundational protocol specification
  • FastMCP - For the excellent Python SDK
  • Open Source Community - For the amazing tools and libraries that power this project
  • Security Researchers - For responsible disclosure and security improvements
  • Contributors - For making this project better every day
  • Users - For trusting us with your blockchain and security operations

Hall of Fame

Core Contributors:

  • Muhammad Mazhar Saeed (Professor) - Project Founder & Lead Architect
  • Your name could be here! Contribute today.

Made with by Muhammad Mazhar Saeed aka Professor

Building the future of decentralized applications with AI-powered automation and enterprise-grade security.

Star this repository if you find it useful!

About

MCP Servers for BlockChain, Cyber Security and AI Automation A cutting-edge Model Context Protocol (MCP) server infrastructure designed to power the next generation of decentralized applications with integrated AI automation and enterprise-grade security.

Topics

Resources

Readme

License

View license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

Languages