orgraph-mcp

# orgraph-mcp Codebase knowledge graph for coding agents. Gives Claude Code, Cursor, Codex, and other MCP-compatible agents a persistent graph of any repo — call chains, topology clusters, dependency trees — on top of hybrid code search. ## Quickstart Install [uv](https://docs.astral.sh/uv/getting-started/installation/), then: ```bash uv tool install orgraph-mcp orgraph install ``` `orgraph install` detects installed coding agents and wires up the MCP server automatically. Open any repo in your agent and orgraph starts working — it indexes on first run, no manual setup needed. To undo: `orgraph uninstall` ## What agents can do Once configured, your agent has 6 tools: | Tool | What it does | |---|---| | `search(query)` | Hybrid BM25+semantic search — find code by description | | `trace(symbol, direction, depth)` | Follow call chains forward (`callees`) or backward (`callers`) | | `find_path(from_symbol, to_symbol)` | Shortest call path between two named symbols | | `get_context(file_or_symbol)` | Topology cluster, community, call depth, indegree — where does this fit? | | `find_entry_points(kind)` | HTTP handlers and entry surfaces; `kind = "all" \| "http" \| "topology"` | | `get_dependencies(file, direction, depth)` | Import + call dependency tree, forward or reverse | | `reindex(force)` | Re-index changed/deleted files without restarting the server | The agent picks the right tool automatically based on what you ask. ## Manual usage All commands take a repo path as the last argument. It defaults to `.` so you can omit it when you're already inside the repo. ### Setup ```bash # Build the index (run once, then again after big merges) orgraph index . # Verify the index is healthy — node/edge counts, clusters, communities orgraph status . ``` ### Finding code ```bash # Find code by describing what it does — semantic + keyword search orgraph search "coupon validation logic" . orgraph search "order cancellation refund" . --top-k 5 # List every function…