Skip to main content
Glama
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**

[![Tools](https://img.shields.io/badge/GitHub%20Tools-20%2C078%2B-38bdf8?style=for-the-badge&logo=github)](https://github.com/fazah-arsenal/github-ai-arsenal)
[![MCP Server](https://img.shields.io/badge/Native%20MCP-17%20Tools%20%2B%20Prompts%20%2B%20Resources-8b5cf6?style=for-the-badge)](scripts/mcp_server.py)
[![Dependencies](https://img.shields.io/badge/Python%20Deps-Zero%20(Stdlib%20Only)-22c55e?style=for-the-badge&logo=python)](scripts/gh_arsenal.py)
[![CLI](https://img.shields.io/badge/Short%20CLI-fazah%20g%20%7C%20fazah%20ui-f59e0b?style=for-the-badge)](scripts/gh_arsenal.py)
[![Registries](https://img.shields.io/badge/Smithery%20%26%20Glama-Ready-06b6d4?style=for-the-badge)](smithery.yaml)
[![Author](https://img.shields.io/badge/Developer-FAZAH-f43f5e?style=for-the-badge)](https://t.me/testtttttttt11222)
[![Telegram](https://img.shields.io/badge/Telegram-@testtttttttt11222-26A5E4?style=for-the-badge&logo=telegram)](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.