Convert des bases de code en un graphe de connaissances SQLite interrogeable pour aider les agents IA à inspecter les relations et à évaluer les modifications de code.
Aussi connu sous Nodesify/astria, @nodesify/astria
- Étoiles
- 3
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 1.6.0
- Dernier commit
- 13 nov. 2026
- Licence
- MIT
Qu'est-ce que Astria MCP ?
Convert des bases de code en un graphe de connaissances SQLite interrogeable pour aider les agents IA à inspecter les relations et à évaluer les modifications de code.
Résumé généré à partir du README du projet
À propos du MCP server Astria
Astria transforme les bases de code en un graphe de connaissances SQLite interrogeable pour aider les agents IA à comprendre les structures logicielles complexes. En utilisant l'extraction par Rust déterministe et tree-sitter, il cartographie les relations entre les symboles et les modules. Cet outil est conçu pour les développeurs qui doivent fournir un contexte structurel profond aux clients IA, leur permettant d'inspecter les implémentations et d'évaluer l'impact des modifications de code avant d'effectuer des éditions.
Le serveur s'exécute localement et nécessite Node.js version 22 ou supérieure. Bien que l'analyse structurelle fonctionne sans aucune clé API, les utilisateurs peuvent optionnellement activer des embeddings locaux ou un enrichissement sémantique à distance pour une récupération améliorée. Le système utilise un répertoire local .astria pour stocker les graphes et les rapports, en utilisant des caches d'extraction pour accélérer les mises à jour. Certaines configurations matérielles, comme les Mac Intel ou certaines builds Linux, peuvent présenter des limitations concernant les embeddings locaux en raison des exigences de ONNX Runtime.
Ce que vous pouvez faire avec
- 1Localiser des implémentations spécifiquesDemandez à l'IA de trouver où une logique particulière, telle que l'authentification, est gérée au sein de la base de code.
- 2Analyser l'impact des modifications de codeDéterminez quelles parties du système sont accessibles ou affectées par une modification proposée sur un nœud spécifique.
- 3Tracer les chemins de relationSuivez les connexions entre un appelant et un appelé pour comprendre le flux d'exécution.
- 4Inspecter les détails des symbolesObtenez une explication détaillée d'un symbole spécifique renvoyé par une requête de graphe.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Astria MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Astria MCP dans Claude Code
$ claude mcp add astria -- npx -y @nodesify/astriaInstaller Astria MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Installer Astria MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"astria": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Installer Astria MCP dans VS Code CLI
$ code --add-mcp '{"name":"astria","type":"stdio","command":"npx","args":["-y","@nodesify/astria"]}'Installer Astria MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Installer Astria MCP dans Codex
$ codex mcp add astria -- npx -y @nodesify/astriaInstaller Astria MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.astria] command = "npx" args = ["-y", "@nodesify/astria"]
Installer Astria MCP dans Gemini CLI
$ gemini mcp add -s user astria npx -- -y @nodesify/astriaInstaller Astria MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblenodesify/astria is public and reachablegithub.com/nodesify/astria ↗Réussi
- Le nom du package correspond au dépôt source@nodesify/astria names nodesify/astria as sourcenpmjs.com/package/@nodesify/astria ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for @nodesify/astrianpmjs.com/package/@nodesify/astria/v/1.6.0#provenance ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-11-06github.com/nodesify/astria ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @nodesify/astriaRéussi
- Aucun avis critique dans le package ou ses dépendances9 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubastria
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.
Questions sur Astria MCP
Comment ajouter Astria MCP à Claude Code ?
Exécutez claude mcp add astria -- npx -y @nodesify/astria dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Astria MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Astria nécessite-t-il une clé API pour l'analyse structurelle ?
Non, l'analyse structurelle est effectuée localement et ne nécessite aucune clé API.
Comment puis-je exclure des fichiers spécifiques du graphe ?
Vous pouvez exclure des fichiers en utilisant un fichier .astriaignore, qui suit la syntaxe gitignore.
Quels sont les prérequis système pour l'installation ?
La version 22 ou supérieure de Node.js est requise.