Verwandelt Codebases in einen abfragbaren SQLite Knowledge Graph, um AI Agents dabei zu unterstützen, Beziehungen zu inspizieren und Code-Änderungen zu bewerten.
Auch bekannt als Nodesify/astria, @nodesify/astria
- Stars
- 3
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.6.0
- Letzter Commit
- 13. Nov. 2026
- Lizenz
- MIT
Was ist Astria MCP?
Astria ist ein MCP server. Verwandelt Codebases in einen abfragbaren SQLite Knowledge Graph, um AI Agents dabei zu unterstützen, Beziehungen zu inspizieren und Code-Änderungen zu bewerten.
Zusammenfassung generiert aus dem README des Projekts
Über Astria MCP server
Astria transformiert Codebases in einen abfragbaren SQLite Knowledge Graph, um AI Agents beim Verständnis komplexer Softwarestrukturen zu helfen. Durch den Einsatz von deterministischem Rust und Tree-sitter Extraction werden Beziehungen zwischen Symbolen und Modulen abgebildet. Dieses Tool ist für Entwickler gedacht, die AI Clients tiefen strukturellen Kontext bereitstellen müssen, damit diese Implementierungen inspizieren und die Auswirkungen von Code-Änderungen bewerten können, bevor sie Edits vornehmen.
Der Server läuft lokal und benötigt Node.js Version 22 oder höher. Während die Strukturanalyse ohne API-Keys funktioniert, können Nutzer optional lokale Embeddings oder remote semantische Anreicherungen für ein verbessertes Retrieval aktivieren. Das System nutzt ein lokales .astria Verzeichnis zum Speichern von Graphs und Reports und verwendet Extraction Caches, um Updates zu beschleunigen. Bestimmte Hardware-Konfigurationen, wie Intel Macs oder spezifische Linux-Builds, können aufgrund von ONNX Runtime Anforderungen Einschränkungen bei lokalen Embeddings haben.
Was du damit machen kannst
- 1Spezifische Implementierungen findenFrage die AI, wo eine bestimmte Logik, wie zum Beispiel die Authentifizierung, innerhalb der Codebase gehandhabt wird.
- 2Auswirkungen von Code-Änderungen analysierenBestimme, welche Teile des Systems durch eine geplante Änderung an einem spezifischen Node erreichbar oder betroffen sind.
- 3Beziehungspfade nachverfolgenVerfolge die Verbindungen zwischen einem Caller und einem Callee, um den Execution Flow zu verstehen.
- 4Symbol-Details inspizierenErhalte eine detaillierte Erklärung eines spezifischen Symbols, das durch eine Graph-Query zurückgegeben wurde.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Astria MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAstria MCP in Claude Code installieren
$ claude mcp add astria -- npx -y @nodesify/astriaAstria MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"astria": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"astria","type":"stdio","command":"npx","args":["-y","@nodesify/astria"]}'Astria MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP in Codex installieren
$ codex mcp add astria -- npx -y @nodesify/astriaAstria MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.astria] command = "npx" args = ["-y", "@nodesify/astria"]
Astria MCP in Gemini CLI installieren
$ gemini mcp add -s user astria npx -- -y @nodesify/astriaAstria MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarnodesify/astria is public and reachablegithub.com/nodesify/astria ↗Bestanden
- Paket nennt dieses Repository als Quelle@nodesify/astria names nodesify/astria as sourcenpmjs.com/package/@nodesify/astria ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @nodesify/astrianpmjs.com/package/@nodesify/astria/v/1.6.0#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-06github.com/nodesify/astria ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @nodesify/astriaBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten9 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenastria
Knowledge graph builder for codebases
Docs | Getting started | CLI Reference | Architecture | Worked examples | Changelog | Release notes | Security
Built by Nodesify
Find an implementation, inspect its relationships, and assess a change before editing. Astria builds a local SQLite knowledge graph with deterministic Rust/tree-sitter extraction. CLI and MCP queries use the same retrieval engine; source locations and evidence classes make results inspectable. Structural analysis needs no API key. Local embeddings and remote semantic enrichment are optional.
Install
npm install -g @nodesify/astria
Node.js >= 22 is required. Prebuilt native binaries ship with the package; installation needs no Rust toolchain. macOS/Linux can also use brew install nodesify/tap/astria (tap).
Intel Mac (darwin-x64), musl Linux and windows-arm64 builds omit local embeddings because ONNX Runtime has no prebuilt runtime there. Structural analysis works; run --embed reports that embeddings are unsupported. Check astria stats --json for embeddingsSupported.
Use the graph
astria run . # build .astria/
astria map # orient by source modules
astria query "where is request authentication implemented"
astria explain <node-id> # inspect a returned symbol
astria path <caller-id> <callee-id> # follow relationships
astria affected <node-id> # assess a proposed change
astria update . # refresh after editing
Use node IDs returned by the graph. Confirm important results against the linked source: name-derived call/import bindings are RESOLVED, and ambiguous targets remain INFERRED. --detail high restricts traversal to EXTRACTED/DECLARED facts. affected reports graph reachability; it cannot prove runtime behavior.
Exclude files with .astriaignore (gitignore syntax). Graphs and reports live under .astria/; read graph_report.md for orientation. Unchanged source reuses extraction caches, while updates reconcile references across the current corpus. After upgrading, run astria update . to refresh cached extraction for qualified call targets.
Guides and evidence
- Install and first graph
- Agent integration, MCP, skills and hooks
- Wiki and exports, semantic enrichment, memory and learning
- CLI reference, graph model, troubleshooting
- Worked examples and retrieval validation, including known limitations
The evaluation harness separates file and declaration retrieval, delivered tokens, search/read cost and graph build time. Historical comparisons used tiny, exercised external sets and a single-pass search floor. New Requests and Commander questions are source-grounded, agent-authored, reserved and unexercised until their first explicit evaluation. No result establishes broad superiority or savings over a complete agent task.
Architecture and languages
Rust workspace with 20 crates plus a Node.js CLI. Uses 42 registered language configurations; exact parser coverage and optional lang-* build features are described in language support. See ARCHITECTURE.md for pipeline, caching and evidence contracts.
Astria is an independent implementation inspired by Graphify, and is not affiliated with or endorsed by that project.
Build from source
# Build Rust core
cargo build --release
# Copy the native library for the source CLI (Linux)
mkdir -p packages/astria-cli/dist
cp target/release/libastria_napi.so packages/astria-cli/dist/astria.node
# Build Node.js CLI
cd packages/astria-cli && npm ci && npm run build
See Contributing for macOS and Windows native artifact paths.
Requires Rust 1.88+ (declared as rust-version in the workspace) and Node.js >= 22.
License
MIT — see LICENSE.
Contributions are welcome and accepted under the Contributor License Agreement — see CONTRIBUTING.md to get started.
Installation defaults to project scope: astria install --platform codex --scope project. Use --scope user explicitly for user-wide integrations. Run astria doctor after setup or upgrades. See the installation lifecycle guide for supported platforms, upgrade, backup/restore and complete removal.
Astria MCP Fragen
Wie füge ich Astria MCP zu Claude Code hinzu?
Führe claude mcp add astria -- npx -y @nodesify/astria in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Astria MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Benötigt Astria einen API-Key für die Strukturanalyse?
Nein, die Strukturanalyse wird lokal durchgeführt und benötigt keinen API-Key.
Wie schließe ich bestimmte Dateien aus dem Graph aus?
Du kannst Dateien über eine .astriaignore ausschließen, die der gitignore-Syntax folgt.
Was sind die Systemvoraussetzungen für die Installation?
Es wird Node.js Version 22 oder höher benötigt.