코드베이스를 쿼리 가능한 SQLite 지식 그래프로 변환하여 AI agent가 관계를 조사하고 코드 변경 사항을 평가할 수 있도록 지원합니다.
다른 이름 Nodesify/astria, @nodesify/astria
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.6.0
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
Astria MCP란?
Astria은(는) MCP server입니다. 코드베이스를 쿼리 가능한 SQLite 지식 그래프로 변환하여 AI agent가 관계를 조사하고 코드 변경 사항을 평가할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Astria MCP server 정보
Astria는 코드베이스를 쿼리 가능한 SQLite 지식 그래프로 변환하여 AI agent가 복잡한 소프트웨어 구조를 이해할 수 있도록 돕습니다. 결정론적인 Rust와 tree-sitter 추출 방식을 사용하여 심볼과 모듈 간의 관계를 매핑합니다. 이 도구는 AI 클라이언트에 심층적인 구조적 컨텍스트를 제공해야 하는 개발자를 위해 설계되었으며, 수정을 진행하기 전에 구현 내용을 조사하고 코드 변경이 미치는 영향을 평가할 수 있습니다.
서버는 로컬에서 실행되며 Node.js 버전 22 이상이 필요합니다. 구조 분석은 API key 없이도 작동하지만, 사용자는 향상된 검색을 위해 로컬 임베딩 또는 원격 시맨틱 인리치먼트를 선택적으로 활성화할 수 있습니다. 시스템은 로컬 .astria 디렉토리를 사용하여 그래프와 보고서를 저장하며, 추출 캐시를 활용해 업데이트 속도를 높입니다. Intel Mac 또는 특정 Linux 빌드와 같은 일부 하드웨어 구성은 ONNX Runtime 요구 사항으로 인해 로컬 임베딩 사용에 제한이 있을 수 있습니다.
활용 사례
- 1특정 구현 위치 찾기인증과 같은 특정 로직이 코드베이스 내 어디에서 처리되는지 AI에게 요청합니다.
- 2코드 변경 영향 분석특정 노드에 대한 수정 제안이 시스템의 어느 부분에 도달하거나 영향을 미치는지 확인합니다.
- 3관계 경로 추적호출자와 피호출자 간의 연결을 따라 실행 흐름을 이해합니다.
- 4심볼 상세 정보 조사그래프 쿼리로 반환된 특정 심볼에 대한 상세 설명을 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Astria MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Astria MCP 설치
$ claude mcp add astria -- npx -y @nodesify/astriaCursor에 Astria MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}VS Code에 Astria MCP 설치
.vscode/mcp.json
{
"servers": {
"astria": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}VS Code CLI에 Astria MCP 설치
$ code --add-mcp '{"name":"astria","type":"stdio","command":"npx","args":["-y","@nodesify/astria"]}'Claude Desktop에 Astria MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Codex에 Astria MCP 설치
$ codex mcp add astria -- npx -y @nodesify/astriaCodex config.toml에 Astria MCP 설치
~/.codex/config.toml
[mcp_servers.astria] command = "npx" args = ["-y", "@nodesify/astria"]
Gemini CLI에 Astria MCP 설치
$ gemini mcp add -s user astria npx -- -y @nodesify/astriaGemini settings.json에 Astria MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능nodesify/astria is public and reachablegithub.com/nodesify/astria ↗통과
- 패키지가 이 저장소를 소스로 명시@nodesify/astria names nodesify/astria as sourcenpmjs.com/package/@nodesify/astria ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @nodesify/astrianpmjs.com/package/@nodesify/astria/v/1.6.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-06github.com/nodesify/astria ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @nodesify/astria통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음9 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
Astria MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add astria -- npx -y @nodesify/astria를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Astria MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
구조 분석을 위해 Astria에서 API key가 필요한가요?
아니요, 구조 분석은 로컬에서 수행되므로 API key가 필요하지 않습니다.
그래프에서 특정 파일을 제외하려면 어떻게 하나요?
gitignore 문법을 따르는 .astriaignore 파일을 사용하여 파일을 제외할 수 있습니다.
설치를 위한 시스템 요구 사항은 무엇인가요?
Node.js 버전 22 이상이 필요합니다.