shashankss1205/codegraphcontext

**Turn code repositories into a queryable graph for AI agents.**
🌐 **Languages:**
- 🇬🇧 English
- 🇨🇳 中文
- 🇰🇷 한국어
- 🇺🇦 Українська
- 🇷🇺 Русский
- 🇯🇵 日本語
- 🇮🇳 தமிழ்
- 🇪🇸 Español (Soon)
🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on GitHub Issues!**
Bridge the gap between deep code graphs and AI context.
A powerful **MCP server** and **CLI toolkit** that indexes local code into a graph database to provide context to AI assistants and developers. Use it as a standalone CLI for comprehensive code analysis or connect it to your favorite AI IDE via MCP for AI-powered code understanding.
---
📍 Quick Navigation
* 🚀 Quick Start
* 📋 Prerequisites
* 🏃 How to Run the Project Locally
* 🌐 Supported Programming Languages
* 🛠️ CLI Toolkit
* 🤖 MCP Server
* 🗄️ Database Options
* 🔬 SCIP indexing (optional)
---
✨ Experience CGC
👨🏻‍💻 Installation and CLI
> Install in seconds with pip and unlock a powerful CLI for code graph analysis.
🛠️ Indexing in Seconds
> The CLI intelligently parses your tree-sitter nodes to build the graph.
🤖 Powering your AI Assistant
> Use natural language to query complex call-chains via MCP.
---
Why CodeGraphContext?
CodeGraphContext is built for the moment when plain text search stops being enough. It turns a repository into a graph of files, symbols, calls, inheritance, imports, and relationships so you can move from "where is this defined?" to "how does this actually connect?" without jumping between tools.
Comparison at a glance
| Approach | Best for | Tradeoff |
| --- | --- | --- |
| grep / file search | Exact string lookup | Misses relationships and code structure |
| RAG over code chunks | Natural-language retrieval | Can lose symbol-level precision |
| CodeGraphContext | Repository-wide reasoning | Requires an indexing step |
Common use cases
- Trace call chains across files and packages.
- Understand class hierarchies, imports, and module boundaries.
- Find dead code, hotspots, and unexpected dependencies.
- Give an AI assistant the same structural context a maintainer would use.
FAQ
- **Do I need a remote service?** No. CGC works locally with embedded backends or with external graph databases when you want them.
- **Is it only for one language?** No. It supports a broad mix of mainstream languages and keeps expanding.
- **Can I use it with an AI assistant?** Yes. That is one of the main reasons the MCP server exists.
---
Project Details
- **Version:** 0.5.1
- **Authors:** Shashank Shekhar Singh
- **License:** MIT License (See LICENSE for details)
- **Website:** CodeGraphContext
---
👨‍💻 Maintainer
**CodeGraphContext** is created and actively maintained by:
**Shashank Shekhar Singh**
- 📧 Email: shashankshekharsingh1205@gmail.com
- 🐙 GitHub: @Shashankss1205
- 🔗 LinkedIn: Shashank Shekhar Singh
- 🌐 Website: codegraphcontext.vercel.app
*Contributions and feedback are always welcome! Feel free to reach out for questions, suggestions, or collaboration opportunities.*
---
Star History
Star History Chart ↗
---
Features
- **Code Indexing:** Analyzes code and builds a knowledge graph of its components.
- **Relationship Analysis:** Query for callers, callees, class hierarchies, call chains and more.
- **Pre-indexed Bundles:** Load famous repositories instantly with .cgc bundles - no indexing required! (Learn more)
- **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (cgc watch).
- **Interactive Setup:** A user-friendly command-line wizard for easy setup.
- **Dual Mode:** Works as a standalone **CLI toolkit** for developers and as an **MCP server** for AI agents.
- **Multi-Language Support:** Full support for 23 programming languages.
- **Flexible Database Backend:** FalkorDB Lite (Default), KuzuDB, LadybugDB, FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
---
🏗️ Architecture & Workflow
CodeGraphContext parses your source code and builds a comprehensive knowledge graph. This graph can be queried directly via the CLI toolkit or exposed to AI assistants through the MCP server.
---
Supported Programming Languages
CodeGraphContext provides comprehensive parsing and analysis for the following languages:
| | Language | | Language | | Language |
| :--- | :--- | :--- | :--- | :--- | :--- |