iflow-mcp_codebadger

# 🦡 codebadger A containerized Model Context Protocol (MCP) server providing static code analysis using Joern's Code Property Graph (CPG) technology with support for Java, C/C++, JavaScript, Python, Go, Kotlin, C#, Ghidra, Jimple, PHP, Ruby, and Swift. ## Prerequisites Before you begin, make sure you have: - **Docker** and **Docker Compose** installed - **Python 3.10+** (Python 3.13 recommended) - **pip** (Python package manager) To verify your setup: ```bash docker --version docker-compose --version python --version ``` ## Quick Start ### 1. Install Python Dependencies ```bash # Create a virtual environment (optional but recommended) python -m venv venv # Install dependencies pip install -r requirements.txt ``` ### 2. Start the Docker Services (Joern) ```bash docker compose up -d ``` This starts: - **Joern Server**: Static code analysis engine (runs CPG generation and queries) Verify services are running: ```bash docker compose ps ``` ### 3. Start the MCP Server ```bash # Start the server python main.py & ``` The MCP server will be available at `http://localhost:4242`. ### 4. Stop All Services ```bash # Stop MCP server (Ctrl+C in terminal) # Stop Docker services docker-compose down # Optional: Clean up everything bash cleanup.sh ``` ## Cleanup Script Use the provided cleanup script to reset your environment: ```bash bash cleanup.sh ``` This will: - Stop and remove Docker containers - Kill orphaned Joern/MCP processes - Clear Python cache (`__pycache__`, `.pytest_cache`) - Optionally clear the playground directory (CPGs and cached codebases) ## Integrations ### GitHub Copilot Integration Edit the MCP configuration file for VS Code (GitHub Copilot): **Path:** ``` ~/.config/Code/User/mcp.json ``` **Example configuration:** ```json { "inputs": [], "servers": { "codebadger": { "url": "http://localhost:4242/mcp", "type": "http" } } } ``` <!-- Removed malformed duplicate GitHub Copilot JSON example --> --- ###…