Codegraph: AI-gestuurde code-intelligentie voor ontwikkelaars en agenten
Codegraph is een MCP-server die is ontworpen om codebases te parseren en een lokale kennisgrafiek te construeren. Ontwikkeld door Colby McHenry, is deze gratis tool gebouwd met TypeScript en bevat het zijn eigen Node.js-runtime (Node ≥22.5). Het integreert met verschillende AI-coderingsagenten zoals Claude Code en Gemini CLI, en biedt mogelijkheden voor verbeterd begrip en interactie met codebases. Codegraph slaat zijn grafgegevens op in een lokale SQLite-database, die FTS5 full-text search biedt voor efficiënte query's. Het heeft als doel de workflows van AI-agenten te versnellen en de productiviteit van ontwikkelaars te verbeteren.
Waar verbindt Codegraph mee?
Codegraph fungeert als een MCP-server die integreert met een codebase, waarbij de structuur wordt geparsed om een gelokaliseerde kennisgrafiek te genereren. Deze grafiek van entiteiten en relaties wordt opgeslagen in een lokale SQLite-database, specifiek op ".codegraph/codegraph.db". De database maakt gebruik van FTS5 full-text search voor efficiënte gegevensopvraging. Compatibele AI-clients verbinden via stdio voor lokale operaties of HTTP voor externe/gedeelde implementaties, met SSE-meldingen. De server ondersteunt een reeks AI-clients, waaronder Claude Code, Cursor, Codex CLI, OpenCode, Hermes Agent, Gemini CLI, Antigravity IDE en Kiro.
Kernfuncties en tools
Codegraph stelt verschillende aanroepbare tools beschikbaar om met codebases te interageren. De index-tool bouwt de kennisgrafiek van entiteiten en relaties. list_file_entities biedt een lijst van alle entiteiten binnen een opgegeven bestand, waarbij een "pad"-string vereist is. list_entity_relationships geeft de relaties van een gegeven entiteit weer, met gebruik van "pad" en "naam"-strings. De codegraph_context-tool map specifieke gebieden van de codebase. Bovendien maakt codegraph_explore het mogelijk om symbolen en hun onderlinge verbindingen te onderzoeken. Deze tools stellen zowel ontwikkelaars als AI-agenten in staat om de code-structuur diepgaand te begrijpen.
Voor wie is het bedoeld?
Codegraph is primair bedoeld voor AI-coderingsagenten zoals Claude Code, Cursor en Gemini CLI, evenals menselijke ontwikkelaars. Het verbetert de mogelijkheden van agenten door gestructureerd begrip van de codebase te bieden, het aantal verkenningsrondes te verminderen en het tokenverbruik te verlagen. Ontwikkelaars profiteren van het vermogen om de impact van veranderingen te beoordelen en efficiënt door grote codebases te navigeren. De lokale werking van de tool zonder externe API-sleutels maakt het geschikt voor omgevingen die prioriteit geven aan gegevensprivacy. Sla dit over als uw primaire behoefte een cloud-gehoste code-intelligentieoplossing met beheerde infrastructuur is.
Hoe te beginnen
Er zijn geen referenties vereist voor de kern lokale functionaliteit van Codegraph. Voor externe HTTP-implementaties kunnen authenticatietokens, zoals HARNESS_MCP_AUTH_TOKEN of x-harness-api-key, worden gebruikt.
Gebruikscases
- Navigatie door grote codebases: Helpt AI-agenten snel toegangspunten en oproepketens te lokaliseren, waardoor de behoefte aan uitgebreide bestandsverkenning vermindert.
- Beoordeling van de impact van veranderingen: Stelt ontwikkelaars en agenten in staat om oproepers, opgeroepenen en de volledige impactradius van een symbool te traceren voordat ze codewijzigingen doorvoeren.
- Versnelling van AI-agenten en contextopbouw: Biedt AI-agenten een gestructureerd begrip van de codebase om het aantal verkenningsrondes te verminderen en het tokenverbruik te verlagen.
Codegraph biedt een lokale, grafiekgebaseerde benadering van code-intelligentie, die zowel ontwikkelaars als AI-agenten bedient. Het verbetert het begrip van code, versnelt de workflows van agenten en helpt bij impactanalyse zonder afhankelijk te zijn van externe diensten. Het vermogen van de tool om nauwkeurige, relevante codecontext te bieden, kan de ontwikkelings efficiëntie aanzienlijk verbeteren.
