Metadata-Version: 2.4
Name: grafio-mcp
Version: 0.3.0
Summary: Structural code knowledge graph for AI coding assistants — impact analysis, cross-service flows, and symbol search via MCP
Author-email: Bikey Rouniyar <bikey.rouniyar@nextuple.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.20
Requires-Dist: fastapi>=0.115
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic-settings>=2.5
Requires-Dist: pydantic>=2.9
Requires-Dist: pygit2>=1.15
Requires-Dist: tomli>=2.0; python_version < '3.11'
Requires-Dist: tree-sitter-go>=0.23
Requires-Dist: tree-sitter-java>=0.23
Requires-Dist: tree-sitter-javascript>=0.23
Requires-Dist: tree-sitter-python>=0.23
Requires-Dist: tree-sitter-rust>=0.23
Requires-Dist: tree-sitter-typescript>=0.23
Requires-Dist: tree-sitter>=0.23
Requires-Dist: typer>=0.12
Requires-Dist: uvicorn[standard]>=0.32
Requires-Dist: watchdog>=5
Provides-Extra: dev
Requires-Dist: httpx; extra == 'dev'
Requires-Dist: mypy>=1.12; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest-cov>=5; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.7; extra == 'dev'
Provides-Extra: embeddings
Requires-Dist: numpy>=2.1; extra == 'embeddings'
Requires-Dist: openai>=1.50; extra == 'embeddings'
Description-Content-Type: text/markdown

# Grafio

Structural code knowledge graph for AI coding assistants.

Grafio indexes your codebase into a symbol-level graph and exposes it via MCP (Model Context Protocol) so AI assistants like Claude can understand cross-service flows, find callers, and analyze impact — without reading every file.

## Install

```bash
pip install grafio              # the daemon
npm install -g grafio-mcp       # the MCP bridge for Claude Code
```

## Quick start

```bash
# Start the daemon (auto-starts when Claude Code opens if grafio is on PATH)
grafio serve

# Index a repo
grafio index --repo-id my-project --root /path/to/my-project
```

Configure Claude Code — create `~/.claude/.mcp.json`:

```json
{
  "mcpServers": {
    "grafio": {
      "command": "grafio-mcp",
      "env": {
        "GRAFIO_URL": "http://127.0.0.1:9742"
      }
    }
  }
}
```

Restart Claude Code. Run `/mcp` to verify.

## What it does

- **`code_graph_context`** — understand a method + everything it calls across files
- **`code_graph_impact`** — find what breaks if you change a symbol
- **`code_graph_search`** — find symbols by name or REST endpoint path
- **`code_graph_update`** — incrementally reindex changed files

Claude automatically decides when to use Grafio vs Grep+Read based on the question.

## Supported languages

Java, TypeScript, JavaScript, Python, Go, Rust

## License

MIT
