github-ai-arsenal
README.md
<div align="center">
<img src="assets/fazah-cover.jpg" alt="FAZAH AI Arsenal v4.0 โ 20,078+ GitHub Tools & Native MCP Server" width="100%"/>
<br/>
# โก FAZAH AI Arsenal v6.0 (`github-ai-arsenal`)
### **Autonomous AI Tool Broker & 17-Tool Native MCP Server (+ Prompts & Resources) โ 20,078+ GitHub Tools, 1-Call Delivery (`fazah g`), Code Snippet Extractor, Isolated Sandbox, Local Web UI & Security Scanner**
[](https://github.com/fazah-arsenal/github-ai-arsenal)
[](scripts/mcp_server.py)
[-22c55e?style=for-the-badge&logo=python)](scripts/gh_arsenal.py)
[](scripts/gh_arsenal.py)
[](smithery.yaml)
[](https://t.me/testtttttttt11222)
[](https://t.me/testtttttttt11222)
> **FAZAH AI Arsenal (`github-ai-arsenal`)** is a zero-dependency **Universal Agent Skill (`SKILL.md`)**, **12-Tool Native Model Context Protocol (`MCP`) Server**, and ultra-short **`fazah` CLI** that equips **Claude Code, Cursor, Google Antigravity, DeepSeek Harness, Windsurf, and OpenAI Codex** with instant offline & online access to **20,078+ real, deduplicated GitHub repositories** across 37 engineering domains.
<img src="assets/hero-banner.svg" alt="FAZAH AI Arsenal Overview Card" width="100%"/>
</div>
---
## ๐จโ๐ป Author & Official Contact
| Field | Details |
| :--- | :--- |
| **Creator & Lead Developer** | **FAZAH** |
| **Telegram** | [@testtttttttt11222](https://t.me/testtttttttt11222) |
| **Email** | [mhamadabdalla150150@gmail.com](mailto:mhamadabdalla150150@gmail.com) |
| **Official Repository** | [github.com/fazah-arsenal/github-ai-arsenal](https://github.com/fazah-arsenal/github-ai-arsenal) |
---
## ๐ Why FAZAH AI Arsenal v4.0?
Instead of letting your AI agent reinvent existing tools from scratch or burn through GitHub API rate limits, **FAZAH AI Arsenal** bundles a compressed offline index of **20,078+ real, battle-tested GitHub repositories** alongside a pure-Python **BM25 search engine**, **Repository Trust & Security Auditor**, **Side-by-Side Comparison Engine**, and **1-Command Project Stack Scaffolder** โ with **zero external Python dependencies**.
<div align="center">
<img src="assets/architecture.svg" alt="FAZAH AI Arsenal Architecture" width="100%"/>
</div>
### โจ Key Capabilities:
1. **๐ 12-Tool Native MCP Server (`scripts/mcp_server.py`)**: Plugs directly into Antigravity, Claude Code, Cursor, Windsurf, and DeepSeek via standard `stdio JSON-RPC 2.0` โ zero `pip install` required.
2. **โก Instant Offline BM25 Search (`fazah m` & `fazah r`)**: Search **20,078+ real GitHub repositories** across 37 domains in milliseconds with zero API rate limits (supports both English & Arabic prompts).
3. **๐ก๏ธ Security & Trust Auditor (`fazah a` & `fazah cmp`)**: Computes a **Trust Score (0โ100)** checking stars, maintenance recency, SPDX license, and repository hygiene โ plus side-by-side repo comparisons.
4. **๐๏ธ 1-Command Project Scaffolder (`fazah st <stack> -s <dir>`)**: Generates ready-to-run starter projects from 8 turnkey blueprints (`saas-ai`, `telegram-ai-bot`, `scraping-rag`, `security-pentest-lab`, `reverse-engineering-lab`, `desktop-app`, `voice-ai-agent`, `mcp-builder`).
5. **๐ Smart Quickstart (`fazah q`)**: Auto-detects any repository's ecosystem (Python, Node, Rust, Go, Docker) and outputs exact install/run commands.
6. **๐ Auto MCP Injector (`fazah mi`)**: Safely injects any MCP server into `.mcp.json` with automatic `.bak` backup.
7. **โญ Local Bookmarks (`fazah bm`)**: Save favorite repositories with custom notes for instant recall.
8. **๐ฆ Pull & Install Without Git (`fazah p` & `fazah is`)**: Download any GitHub repo ZIP or install any repo as a local `SKILL.md` without requiring `git`.
---
## ๐ฅ๏ธ Live CLI Preview
<div align="center">
<img src="assets/cli-preview.svg" alt="FAZAH AI Arsenal CLI Preview" width="100%"/>
</div>
---
## โก 1-Command Installation
Installs the Universal Skill into `~/.agents/skills`, `~/.gemini/config/skills` (plus Claude/Cursor/Codex if present) and registers the global **`fazah`** CLI command automatically:
### Windows (PowerShell)
```powershell
irm "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.ps1" | iex
```
*(Or locally after downloading: `.\install.ps1`)*
### Linux / macOS
```bash
curl -fsSL "https://raw.githubusercontent.com/fazah-arsenal/github-ai-arsenal/main/install.sh" | bash
```
*(Or locally: `chmod +x install.sh && ./install.sh`)*
---
## ๐ Connect as a Native MCP Server
Inject automatically into your workspace `.mcp.json`:
```bash
fazah mi github-ai-arsenal
```
Or paste into your MCP client configuration (Antigravity, Claude Code, Cursor, Windsurf, DeepSeek):
```json
{
"mcpServers": {
"github-ai-arsenal": {
"command": "python",
"args": ["~/.agents/skills/github-ai-arsenal/scripts/mcp_server.py"]
}
}
}
```
### ๐งฐ 12 Native MCP Tools Exposed:
| MCP Tool | Description |
| :--- | :--- |
| `arsenal_recommend` | Intelligent tool recommender (Core Elite + 20,078+ Mega Index) |
| `arsenal_search_offline` | Instant offline BM25 search across 20,078+ repos with zero rate limits |
| `arsenal_stack` | Browse 8 turnkey project stacks with install commands |
| `arsenal_scaffold_stack` | Scaffold a complete starter project folder (`README.md`, `setup_stack`, `.env.example`, `.mcp.json`) |
| `arsenal_quickstart` | Auto-detect language/ecosystem and output exact install & run commands |
| `arsenal_compare` | Compare 2+ GitHub repositories side-by-side (Trust Score, Stars, License) |
| `arsenal_audit_repo` | Security & Trust Score (0โ100) audit before pulling or running code |
| `arsenal_bookmark` | Add, list, or remove bookmarked favorite tools with notes |
| `arsenal_mcp_inject` | Safely inject any MCP server into `.mcp.json` with backup |
| `arsenal_inspect_repo` | Inspect repo metadata, top files, and `README.md`/`SKILL.md` without cloning |
| `arsenal_pull_repo` | Download and extract any GitHub repository ZIP without `git` |
| `arsenal_install_skill` | Auto-discover or synthesize `SKILL.md` and install any repo as a local skill |
---
## ๐ ๏ธ Ultra-Short CLI Cheatsheet (`fazah`)
```bash
fazah g "convert pdf to markdown" # 1-Call Autonomous Tool Broker (pick + scan + snippet)
fazah g "web scraper" --pull # Pick, security-scan & auto-download ZIP in 1 call
fazah sn unclecode/crawl4ai # Extract clean runnable code snippets (saves 85% tokens)
fazah mem log unclecode/crawl4ai -t scrape # Log verified working tool into agent experience memory
fazah try unclecode/crawl4ai # Pull into isolated Python venv sandbox safely
fazah ui # Launch Interactive Local Web Dashboard (http://127.0.0.1:8765)
fazah az . # Analyze current project & recommend missing tools/MCPs
fazah scan unclecode/crawl4ai # Deep supply-chain security scan of setup.py/package.json
fazah doc # Check local runtimes, skills & index health
fazah info # Show breakdown of 20,078+ tools across 37 domains
fazah r "telegram bot and web scraping" # Smart tool recommender (English & Arabic)
fazah m -q "postgres vector" -n 10 # Instant offline BM25 search across 20k+ repos
fazah q unclecode/crawl4ai # Auto-detect install & run commands
fazah a modelcontextprotocol/servers # Security & Trust Score (0-100) audit
fazah cmp unclecode/crawl4ai mendableai/firecrawl # Side-by-side repo comparison
fazah st list # List all 8 turnkey project stacks
fazah st saas-ai -s ./my-saas-app # Scaffold a complete starter project
fazah bm add unclecode/crawl4ai -m "Best" # Bookmark a favorite repository
fazah mi github-ai-arsenal # Auto-inject MCP server into .mcp.json
fazah t -t mcp # Fetch live trending GitHub repos
fazah s "deepseek coding agent" # Live GitHub API search
fazah i danielmiessler/fabric # Inspect repo structure & README without cloning
fazah p unclecode/crawl4ai -d ./tools # Download & extract repo ZIP without git
fazah is anthropics/skills # Install any GitHub repo as a local SKILL.md
```
### ๐ฆ Install via Python `pip`
```bash
pip install git+https://github.com/fazah-arsenal/github-ai-arsenal.git
```
*(Full command names like `fazah recommend` and `python scripts/gh_arsenal.py recommend` also work identically.)*
---
## ๐ Domain Coverage (20,078+ Real Indexed Repositories)
| Domain | Indexed Tools | Highlights |
| :--- | :---: | :--- |
| `mcp-servers` | **5,032** | Official & community MCP servers for DBs, browsers, cloud, filesystems |
| `go-systems` & `rust-systems` | **4,613** | High-performance systems, networking, CLI & infrastructure tools |
| `devops-cloud` & `cpp-systems` | **2,289** | Docker, Kubernetes, CI/CD, cloud-native & low-level C/C++ libraries |
| `machine-learning` & `ai-agents` & `ai-llm` | **1,452** | Multi-agent swarms, LLM routers, local inference, RAG & fine-tuning |
| `ui-frontend` & `javascript-web` | **1,418** | React, Next.js, Tailwind, shadcn/ui & modern frontend ecosystems |
| `media-audio-video` | **1,130** | Speech-to-Text (Whisper), TTS (Kokoro), video processing & FFmpeg tools |
| `security-pentest` & `osint-recon` & `reverse-engineering` | **778** | SAST scanners, secret hunters, APK/ASAR/binary decompilers & OSINT |
| `dotnet-csharp` / `python` / `java-jvm` / `php-web` / `mobile-desktop` / `blockchain-web3` | **2,650+** | Full-stack libraries, desktop GUIs, mobile apps, Web3 & game dev |
---
## ๐งช Running Automated Tests
```bash
python -m unittest tests/test_arsenal.py
```
---
## ๐ Connect With the Developer
* **Author**: **FAZAH**
* **Telegram**: [@testtttttttt11222](https://t.me/testtttttttt11222)
* **Email**: `mhamadabdalla150150@gmail.com`
---
## ๐ License
Released under the **MIT License** โ free for personal, open-source, and commercial AI workflows.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues