本体索引

Third-party Prerequisites

OntoIndex runs on Node.js and uses native parser packages for some languages. Install the following before installing OntoIndex.

Linux example:

node --version
npm --version
git --version
python3 --version
make --version
g++ --version

Windows PowerShell example:

node --version
npm --version
git --version
python --version
npm config get msvs_version

Installation

Install the Latest GitHub Release

Linux and macOS:

curl -fsSL https://raw.githubusercontent.com/ontograph/ontoindex/master/scripts/install-ontoindex-latest.sh | bash
ontoindex --version

Windows PowerShell:

iwr -useb https://raw.githubusercontent.com/ontograph/ontoindex/master/scripts/install-ontoindex-latest.ps1 | iex
ontoindex --version

Windows note:

• With Node.js 22 LTS, use npm 11.6.0 or newer on Windows.
• Older npm releases can bundle node-gyp builds that fail to detect Visual Studio 2026 Build Tools.
• Upgrade with npm.cmd install -g npm@11.6.3 before retrying the installer.

From a local checkout:

The installers fetch the latest GitHub release, locate the ontoindex-*.tgz asset, and install it with npm install -g. If a global install is not writable, they fall back to a user npm prefix.

If a Windows install previously failed partway through and left a broken ontoindex.cmd shim, repair the global install state before retrying:

npm.cmd uninstall -g ontoindex
if (Test-Path "$env:APPDATA\npm\node_modules\ontoindex") { Remove-Item "$env:APPDATA\npm\node_modules\ontoindex" -Recurse -Force }
if (Test-Path "$env:APPDATA\npm\ontoindex.cmd") { Remove-Item "$env:APPDATA\npm\ontoindex.cmd" -Force }
if (Test-Path "$env:APPDATA\npm\ontoindex.ps1") { Remove-Item "$env:APPDATA\npm\ontoindex.ps1" -Force }

Installer configuration:

Install with npm

Use this path when npm publication is available in your environment.

Install from a Release Tarball URL

Use this when you want an immutable GitHub release asset.

MCP Setup

ontoindex setup configures supported MCP clients automatically. Manual examples are useful for debugging or for clients that do not support automatic setup.

Cursor example:

{
  "mcpServers": {
    "ontoindex": {
      "command": "ontoindex",
      "args": ["mcp"]
    }
  }
}

OpenCode example:

{
  "mcp": {
    "ontoindex": {
      "type": "local",
      "command": ["ontoindex", "mcp"]
    }
  }
}

Docker

Images:

Common Agent Workflows

Core MCP surfaces include:

Indexing Pipeline

The graph build is a typed phase DAG:

scan -> structure -> [markdown, cobol] -> parse -> [routes, tools, orm]
  -> crossFile -> mro -> communities -> processes

Key steps:

1. Scan files with repository ignore rules.
2. Parse supported languages with Tree-sitter providers.
3. Resolve imports, calls, receivers, constructors, type hints, inheritance, and method-resolution-order edges.
4. Enrich the graph with routes, MCP/RPC tools, ORM queries, markdown sections, communities, and execution flows.
5. Persist nodes and relations into LadybugDB under .ontoindex/.
6. Expose the same graph through CLI, MCP, HTTP, web UI, generated wiki pages, and generated skills.

Supported language depth varies, but the shared model covers TypeScript, JavaScript, Python, Java, Kotlin, C#, Go, Rust, PHP, Ruby, Swift, C, C++, Dart, and protobuf-related parser support.

Comparison With Related Tools

This table compares functional scope, not benchmark speed.

Practical guidance:

• Choose OntoIndex when an agent must edit or release from local evidence: impact, diff review, docs drift, audit workflows, and target-repository safeguards.
• Choose Graphify when the main deliverable is a broad human-readable project knowledge graph across mixed artifacts.
• Choose CodeGPT Deep Graph MCP when your graph already lives in CodeGPT/DeepGraph.
• Choose smaller code-graph MCP servers when you only need AST/call/dependency lookup without a broader audit lifecycle.
• Choose Serena for language-server style symbolic edits.
• Choose Graphiti MCP for temporal memory over facts and events; it complements OntoIndex rather than replacing a source-code index.