Metadata-Version: 2.4
Name: orgraph-mcp
Version: 0.1.0
Summary: Codebase knowledge graph MCP server — call chains, topology, and hybrid search for coding agents
Project-URL: Homepage, https://github.com/tss-pranavkumar/orgraph
Project-URL: Repository, https://github.com/tss-pranavkumar/orgraph
Project-URL: Bug Tracker, https://github.com/tss-pranavkumar/orgraph/issues
Author-email: Pranav Kumar <pranav.kumar@thesouledstore.com>
License: MIT
License-File: LICENSE
Keywords: agents,code-search,codebase,knowledge-graph,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: fastmcp>=2.0
Requires-Dist: kuzu>=0.8
Requires-Dist: networkx>=3.4
Requires-Dist: orjson>=3.9
Requires-Dist: pathspec>=0.12
Requires-Dist: protobuf<3.21,>=3.20
Requires-Dist: questionary>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: semble>=0.3.4
Requires-Dist: tree-sitter-javascript>=0.23
Requires-Dist: tree-sitter-python>=0.23
Requires-Dist: tree-sitter-typescript>=0.23
Requires-Dist: tree-sitter<0.26,>=0.23
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# orgraph

Codebase knowledge graph for coding agents. Points at any repo, builds a persistent graph, serves it via MCP.

## Install

```bash
uv venv && uv pip install -e .
```

## Usage

```bash
# Index a repo
orgraph index /path/to/repo

# Check graph stats
orgraph status /path/to/repo

# Search code
orgraph search "authentication middleware" /path/to/repo

# Start MCP server (add to Cursor / Claude CLI config)
orgraph serve /path/to/repo
```

## MCP config (Claude CLI)

```json
{
  "mcpServers": {
    "orgraph": { "command": "orgraph", "args": ["serve", "."] }
  }
}
```

## Architecture

See [plan](../.claude/plans/i-wnant-you-to-glowing-pelican.md) for full design.

- **Extraction**: SCIP (compiler-accurate) → tree-sitter fallback (graphify)
- **Storage**: Kuzu embedded graph DB
- **Search**: semble hybrid BM25 + Model2Vec
- **Topology**: codewiki BFS entry-point clustering
- **Communities**: Leiden community detection (graphify)
- **Agent interface**: FastMCP stdio server, 5 tools
