⚡ Northveil Universal AI MCP Server & Status Portal

Northveil Universal AI MCP Server is a production-grade Model Context Protocol (MCP) server providing real-time multi-chain Web3 wallet execution, smart contract auto-compilation, automated deployment, token swaps, and Supabase CDN storage asset hosting for AI assistants including Claude Desktop, ChatGPT Custom Actions, Cursor IDE, and Windsurf.

---

🌟 Key Capabilities & Features

1. 🔌 Remote SSE & JSON-RPC Gateway:
   • 1-click connection via http://localhost:3001/sse?wallet_address=0x...
   • Zero JSON configuration files required.
2. 📜 Smart Contract Auto-Compilation & Deployment (create_smart_contract):
   • Generates production-ready OpenZeppelin ERC-20 / ERC-721 / ERC-1155 / Staking Solidity contracts.
   • Automatically generates dynamic SVG logos and hosts metadata JSON on Supabase Storage.
3. 🖼️ Supabase Storage Asset Uploader (upload_contract_asset):
   • Accepts raw Base64 image payloads dropped by users in AI chat sessions.
   • Decodes and uploads to Supabase CDN bucket contract-metadata.
4. 📊 Real System Telemetry Engine (mcp-status):
   • Queries live Node.js CPU cores, memory utilization, load average, and disk storage.
   • Live Supabase Postgres DB row counters (transactions, contracts, api_keys).

---

🚀 Quick Start & Deployment

1. Installation

git clone https://github.com/Fortunehack45/Northveil-MCP.git
cd Northveil-MCP
npm install

2. Environment Configuration (.env)

PORT=3001
VITE_SUPABASE_URL=https://YOUR_SUPABASE_PROJECT_ID.supabase.co
VITE_SUPABASE_ANON_KEY=YOUR_SUPABASE_ANON_KEY_HERE
SUPABASE_SERVICE_ROLE_KEY=YOUR_SUPABASE_SERVICE_ROLE_KEY_HERE
VITE_1INCH_API_KEY=YOUR_1INCH_API_KEY_HERE

3. Run Locally

# Start MCP AI Server
npx tsx index.ts

# Start Standalone MCP Status Portal
cd mcp-status
npm run dev

---

🛠️ MCP Tools Offered

Tool Name	Description
create_smart_contract	Compiles & deploys ERC-20/ERC-721 contracts with auto-hosted Supabase logos.
upload_contract_asset	Uploads base64 logo image assets directly to Supabase Storage CDN.
get_portfolio	Queries real-time wallet balances, liquid reserves, and tokens.
buy_tokens / sell_tokens	Executes token swaps via 1inch v6 DEX aggregator.
audit_contract	Performs security static analysis on Solidity smart contract code.

---

📄 License

MIT License. Published & Maintained by Northveil Protocol.