Преобразует кодовые базы в графы знаний SQLite, доступные для запросов, помогая AI-агентам анализировать связи и оценивать изменения в коде.
Также известен как Nodesify/astria, @nodesify/astria
- Звёзды
- 3
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- 1.6.0
- Последний коммит
- 13 нояб. 2026 г.
- Лицензия
- MIT
Что такое Astria MCP?
Преобразует кодовые базы в графы знаний SQLite, доступные для запросов, помогая AI-агентам анализировать связи и оценивать изменения в коде.
Сводка сгенерирована из README проекта
О Astria MCP server
Astria преобразует кодовые базы в графы знаний SQLite, доступные для запросов, чтобы помочь AI-агентам разобраться в сложных структурах программного обеспечения. Используя детерминированный Rust и извлечение через tree-sitter, инструмент сопоставляет связи между символами и модулями. Этот инструмент предназначен для разработчиков, которым необходимо предоставить AI-клиентам глубокий структурный контекст, позволяя им изучать реализации и оценивать влияние изменений в коде перед внесением правок.
Сервер запускается локально и требует Node.js версии 22 или выше. Хотя структурный анализ работает без API-ключей, пользователи могут по желанию включить локальные эмбеддинги или удаленное семантическое обогащение для улучшенного поиска. Система использует локальную директорию .astria для хранения графов и отчетов, используя кэш извлечения для ускорения обновлений. Определенные конфигурации оборудования, такие как Intel Mac или специфические сборки Linux, могут иметь ограничения по работе с локальными эмбеддингами из-за требований ONNX Runtime.
Что вы можете с ним делать
- 1Поиск конкретных реализацийПопросите AI найти, где именно в кодовой базе обрабатывается определенная логика, например, аутентификация.
- 2Анализ влияния изменений в кодеОпределите, какие части системы достижимы или затронуты предлагаемым изменением конкретного узла.
- 3Отслеживание путей связейПроследите связи между вызывающим и вызываемым кодом, чтобы понять поток выполнения.
- 4Изучение деталей символовПолучите подробное описание конкретного символа, возвращенного запросом к графу.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Astria MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Astria MCP в Claude Code
$ claude mcp add astria -- npx -y @nodesify/astriaУстановка Astria MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Установка Astria MCP в VS Code
.vscode/mcp.json
{
"servers": {
"astria": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Установка Astria MCP в VS Code CLI
$ code --add-mcp '{"name":"astria","type":"stdio","command":"npx","args":["-y","@nodesify/astria"]}'Установка Astria MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Установка Astria MCP в Codex
$ codex mcp add astria -- npx -y @nodesify/astriaУстановка Astria MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.astria] command = "npx" args = ["-y", "@nodesify/astria"]
Установка Astria MCP в Gemini CLI
$ gemini mcp add -s user astria npx -- -y @nodesify/astriaУстановка Astria MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"astria": {
"command": "npx",
"args": [
"-y",
"@nodesify/astria"
]
}
}
}Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторий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 ↗Пройдено
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний год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
Открыть на 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.
Вопросы о Astria MCP
Как добавить Astria MCP в Claude Code?
Выполните claude mcp add astria -- npx -y @nodesify/astria в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Astria MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Требуется ли API-ключ для структурного анализа в Astria?
Нет, структурный анализ выполняется локально и не требует API-ключа.
Как исключить определенные файлы из графа?
Вы можете исключить файлы с помощью .astriaignore, который использует синтаксис gitignore.
Какие системные требования для установки?
Требуется Node.js версии 22 или выше.