Kod tabanlarını, AI agent'ların ilişkileri incelemesine ve kod değişikliklerini değerlendirmesine yardımcı olmak için sorgulanabilir bir SQLite bilgi grafiğine dönüştürür.
Ayrıca bilinen adı Nodesify/astria, @nodesify/astria
- Yıldızlar
- 3
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.6.0
- Son commit
- 13 Kas 2026
- Lisans
- MIT
Astria MCP nedir?
Astria bir MCP sunucusudur. Kod tabanlarını, AI agent'ların ilişkileri incelemesine ve kod değişikliklerini değerlendirmesine yardımcı olmak için sorgulanabilir bir SQLite bilgi grafiğine dönüştürür.
Özet, projenin README dosyasından oluşturuldu
Astria MCP sunucusu hakkında
Astria, karmaşık yazılım yapılarını anlamada AI agent'lara yardımcı olmak için kod tabanlarını sorgulanabilir bir SQLite bilgi grafiğine dönüştürür. Deterministik Rust ve tree-sitter çıkarımı kullanarak semboller ve modüller arasındaki ilişkileri haritalandırır. Bu araç, AI istemcilerine derin yapısal bağlam sağlaması gereken geliştiriciler için tasarlanmıştır; böylece düzenleme yapmadan önce implementasyonları incelemelerine ve kod değişikliklerinin etkisini değerlendirmelerine olanak tanır.
Sunucu yerel olarak çalışır ve Node.js sürüm 22 veya üzeri gerektirir. Yapısal analiz herhangi bir API anahtarı olmadan çalışırken, kullanıcılar gelişmiş geri getirme işlemleri için isteğe bağlı olarak yerel embedding'leri veya uzak semantik zenginleştirmeyi etkinleştirebilirler. Sistem, grafikleri ve raporları depolamak için yerel bir .astria dizini kullanır ve güncellemeleri hızlandırmak için çıkarım önbelleklerinden yararlanır. Intel Mac'ler veya belirli Linux sürümleri gibi bazı donanım yapılandırmaları, ONNX Runtime gereksinimleri nedeniyle yerel embedding'ler konusunda kısıtlamalara sahip olabilir.
Neler yapabilirsiniz
- 1Belirli implementasyonları bulmaAI'dan, kimlik doğrulama gibi belirli bir mantığın kod tabanı içinde nerede işlendiğini bulmasını isteyin.
- 2Kod değişikliği etkisini analiz etmeBelirli bir düğümde önerilen bir değişikliğin sistemin hangi kısımlarına ulaşılabileceğini veya hangi kısımları etkileyeceğini belirleyin.
- 3İlişki yollarını izlemeYürütme akışını anlamak için bir çağırıcı (caller) ile çağrılan (callee) arasındaki bağlantıları takip edin.
- 4Sembol detaylarını incelemeBir grafik sorgusu tarafından döndürülen belirli bir sembol hakkında ayrıntılı açıklama alın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Astria MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleAstria MCP'yi Claude Code içine yükleyin
$ claude mcp add astria -- npx -y @nodesify/astriaAstria MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"astria": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"astria","type":"stdio","command":"npx","args":["-y","@nodesify/astria"]}'Astria MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Astria MCP'yi Codex içine yükleyin
$ codex mcp add astria -- npx -y @nodesify/astriaAstria MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.astria] command = "npx" args = ["-y", "@nodesify/astria"]
Astria MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user astria npx -- -y @nodesify/astriaAstria MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirnodesify/astria is public and reachablegithub.com/nodesify/astria ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@nodesify/astria names nodesify/astria as sourcenpmjs.com/package/@nodesify/astria ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @nodesify/astrianpmjs.com/package/@nodesify/astria/v/1.6.0#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-06github.com/nodesify/astria ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @nodesify/astriaGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok9 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
astria
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 soruları
Astria MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add astria -- npx -y @nodesify/astria komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Astria MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Yapısal analiz için Astria bir API anahtarı gerektiriyor mu?
Hayır, yapısal analiz yerel olarak gerçekleştirilir ve herhangi bir API anahtarı gerektirmez.
Belirli dosyaları grafikten nasıl hariç tutabilirim?
gitignore sözdizimini takip eden .astriaignore dosyasını kullanarak dosyaları hariç tutabilirsiniz.
Kurulum için sistem gereksinimleri nelerdir?
Node.js sürüm 22 veya üzeri gereklidir.