コードベースをクエリ可能なSQLiteナレッジグラフに変換し、AIエージェントによるリレーションシップの調査やコード変更の影響評価を支援します。
別名 Nodesify/astria, @nodesify/astria
- スター
- 3
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.6.0
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
Astria MCPとは
コードベースをクエリ可能なSQLiteナレッジグラフに変換し、AIエージェントによるリレーションシップの調査やコード変更の影響評価を支援します。
プロジェクトのREADMEから生成された概要
Astria MCP server について
Astriaは、コードベースをクエリ可能なSQLiteナレッジグラフに変換することで、AIエージェントが複雑なソフトウェア構造を理解するのを支援します。決定論的なRustとtree-sitterによる抽出を用いることで、シンボルとモジュール間のリレーションシップをマッピングします。このツールは、AIクライアントに深い構造的コンテキストを提供する必要がある開発者向けに設計されており、コードを編集する前に実装内容の調査やコード変更の影響評価を行うことができます。
サーバーはローカルで動作し、Node.js version 22 以上が必要です。構造解析はAPIキーなしで機能しますが、検索機能を強化するために、ローカルでの埋め込み(embeddings)やリモートでのセマンティック・エンリッチメントをオプションで有効にできます。システムはローカルの .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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
構造解析にAstriaのAPIキーは必要ですか?
いいえ、構造解析はローカルで実行されるため、APIキーは不要です。
特定のファイルをグラフから除外するにはどうすればよいですか?
gitignoreの構文に従う .astriaignore を使用して、ファイルを対象外にできます。
インストールに必要なシステム要件は何ですか?
Node.js version 22 以上が必要です。