ontomics — Claude Code MCP server: features and setup
ontomics indexes a codebase’s domain concepts, naming patterns, and functions with similar behavior. Use it to explore project vocabulary and trace how concepts connect through code.
claude mcp add ontomics -- npx -y @ontomics/ontomicsWhat ontomics does
The server groups related symbols into concepts, detects naming patterns, and finds functions whose implementations behave alike. Ask it for a symbol’s signature and relationships, follow a concept through call chains, or compare the project vocabulary with a Git ref. Behavioral matching uses CodeRankEmbed on function bodies.
Its MCP tools can suggest names that fit a project, locate files and signatures tied to a concept, and export domain knowledge as YAML for another repository. It supports Python, TypeScript, JavaScript, and Rust, detected from file extensions. Indexing requires a Git repository: without a .git/ directory, the server refuses to index unless you pass --force.
Install the package and register the server separately. In Claude Code, registration starts ontomics through npx. The server detects the repository and indexes it on first run; it refuses to index home, root, or temporary directories.
What it helps with
- find related terms and occurrences for a domain concept
- trace a concept through code call chains
- check an identifier against project naming patterns
- find functions with similar behavior
- compare domain vocabulary with a Git ref
Example prompts for the agent
- Find concepts related to “transform” and show where they occur.
- Check whether
spatial_transformfits this project’s naming patterns and suggest a canonical name. - Find functions whose behavior resembles
spatial_transform().
How to install ontomics
Platform CLI
claude mcp add ontomics -- npx -y @ontomics/ontomicsPlatform CLI
codex mcp add ontomics -- npx -y @ontomics/ontomicsConfig file
{
"mcpServers": {
"ontomics": {
"command": "npx",
"args": [
"-y",
"@ontomics/ontomics"
]
}
}
}Config file
{
"servers": {
"ontomics": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ontomics/ontomics"
]
}
}
}Platform CLI
gemini mcp add ontomics npx -y @ontomics/ontomicsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ontomics
How do I install ontomics in Claude Code?
Register it with claude mcp add ontomics -- npx -y @ontomics/ontomics. The project must be a Git repository for indexing.
What does ontomics do?
It indexes domain concepts, naming patterns, and behavioral similarities between functions. Its MCP tools help explore symbol relationships and follow concepts through a codebase.
Which programming languages does ontomics support?
Python, TypeScript, JavaScript, and Rust. It detects languages from file extensions.
