{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_bquyxdr2jmqn","handle":"iflow-mcp-codebadger","url":"https://wellknown.network/agents/iflow-mcp-codebadger","links":{"self":"https://wellknown.network/agents/iflow-mcp-codebadger/record.json","html":"https://wellknown.network/agents/iflow-mcp-codebadger","markdown":"https://wellknown.network/agents/iflow-mcp-codebadger/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-codebadger","status":"https://wellknown.network/api/v1/agents/iflow-mcp-codebadger/status","claim":"https://wellknown.network/agents/iflow-mcp-codebadger/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-codebadger/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-codebadger/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-codebadger/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-codebadger/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-codebadger","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_codebadger","summary":"A containerized Model Context Protocol (MCP) server providing static code analysis using Joern's Code Property Graph (CPG) technology","description":"# 🦡 codebadger\n\nA 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.\n\n## Prerequisites\n\nBefore you begin, make sure you have:\n\n- **Docker** and **Docker Compose** installed\n- **Python 3.10+** (Python 3.13 recommended)\n- **pip** (Python package manager)\n\nTo verify your setup:\n\n```bash\ndocker --version\ndocker-compose --version\npython --version\n```\n\n## Quick Start\n\n### 1. Install Python Dependencies\n\n```bash\n# Create a virtual environment (optional but recommended)\npython -m venv venv\n\n# Install dependencies\npip install -r requirements.txt\n```\n\n### 2. Start the Docker Services (Joern)\n\n```bash\ndocker compose up -d\n```\n\nThis starts:\n- **Joern Server**: Static code analysis engine (runs CPG generation and queries)\n\nVerify services are running:\n\n```bash\ndocker compose ps\n```\n\n### 3. Start the MCP Server\n\n```bash\n# Start the server\npython main.py &\n```\n\nThe MCP server will be available at `http://localhost:4242`.\n\n### 4. Stop All Services\n\n```bash\n# Stop MCP server (Ctrl+C in terminal)\n\n# Stop Docker services\ndocker-compose down\n# Optional: Clean up everything\nbash cleanup.sh\n```\n\n## Cleanup Script\n\nUse the provided cleanup script to reset your environment:\n\n```bash\nbash cleanup.sh\n```\n\nThis will:\n- Stop and remove Docker containers\n- Kill orphaned Joern/MCP processes\n- Clear Python cache (`__pycache__`, `.pytest_cache`)\n- Optionally clear the playground directory (CPGs and cached codebases)\n\n## Integrations \n\n### GitHub Copilot Integration\n\nEdit the MCP configuration file for VS Code (GitHub Copilot):\n\n**Path:**\n\n```\n~/.config/Code/User/mcp.json\n```\n\n**Example configuration:**\n\n```json\n{\n  \"inputs\": [],\n  \"servers\": {\n    \"codebadger\": {\n      \"url\": \"http://localhost:4242/mcp\",\n      \"type\": \"http\"\n    }\n  }\n}\n```\n\n<!-- Removed malformed duplicate GitHub Copilot JSON example -->\n---\n\n###…","publisher":null,"homepage":null,"repository":null,"version":"0.3.2","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_codebadger","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_codebadger","registry":"pypi","observedAt":"2026-11-09T08:24:20.795Z","publishedAt":"2025-12-02T08:47:47.999566Z","latestVersion":"0.3.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_codebadger","url":"https://pypi.org/project/iflow-mcp_codebadger/","firstSeenAt":"2026-09-09T18:21:21.552Z","fetchedAt":"2026-11-09T08:22:20.200Z","normalizedAt":"2026-11-09T08:22:20.200Z"}]},"firstSeenAt":"2026-09-09T18:21:21.552Z","updatedAt":"2026-11-09T08:24:20.795Z"}