MCP AST Explorer
БесплатноНе проверенPython symbol exploration for codebase onboarding agents.
Описание
Python symbol exploration for codebase onboarding agents.
README
MCP server for deterministic Python codebase symbol exploration.
mcp-ast-explorer indexes Python source files with LibCST and exposes focused MCP tools for codebase onboarding: definition lookup, function signatures, local references, direct call chains, and simple class hierarchy queries.
Codebase Onboarding Stack
mcp-ast-explorer is the semantic symbol layer in a three-server MCP tool stack for Project 6 wayfinder, a codebase onboarding agent.
- mcp-repo-mapper maps repository structure, languages, entry points, framework evidence, and Python dependency edges.
- mcp-ast-explorer provides symbol-grounded Python definition, signature, reference, call-chain, and class-hierarchy lookups.
- mcp-test-runner runs local pytest/Jest checks and coverage summaries so agent claims can be verified against execution.
In wayfinder, this server feeds entry-point and symbol explanation while refusing to invent missing symbols.
Status
This is a Python-only v1. TypeScript is registered as an unsupported backend placeholder so the server has an explicit extension point, but TypeScript analysis is not implemented yet.
The server does not use an LLM for symbol lookup. If a requested symbol or class is not present in the parsed index, tools return a structured not-found result instead of inventing an answer.
Tools
| Tool | Purpose |
|---|---|
health() |
Returns ok for smoke checks. |
find_definition(path, symbol, language="python") |
Finds a module, class, function, or method definition. |
function_signature(path, symbol, language="python") |
Returns the signature for a function or method symbol. |
find_references(path, symbol, language="python") |
Returns same-module CST name references for an existing symbol. |
call_chain(path, from_symbol, depth=2, language="python") |
Returns direct callers detected from local references. |
class_hierarchy(path, class_name, language="python") |
Returns direct subclasses detected from simple base-class names. |
Supported Scope
- Python files parsed by LibCST.
- Symbol kinds: modules, classes, functions, and methods.
- Same-module reference lookup for simple names.
- Direct caller detection from function or method containers.
- Direct subclass detection for simple
class Child(Base):inheritance. - Structured error responses for unsupported languages and missing symbols.
Current Limitations
- Cross-file imports and package-wide resolution are out of scope for v1.
- Aliases, star imports, dynamic attribute access, and qualified references are not resolved.
call_chaincurrently returns direct callers only; recursive multi-hop expansion is not implemented.class_hierarchycurrently returns direct subclasses only and handles simple base names.- TypeScript is intentionally unsupported in v1.
Local Development
Install dependencies:
uv sync --extra dev
Run the MCP server:
uv run mcp-ast-explorer
Run verification:
uv run ruff check .
uv run mypy
uv run pytest
License
MIT
Установить MCP AST Explorer в Claude Desktop, Claude Code, Cursor
unyly install mcp-ast-explorerСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add mcp-ast-explorer -- uvx mcp-ast-explorerFAQ
MCP AST Explorer MCP бесплатный?
Да, MCP AST Explorer MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для MCP AST Explorer?
Нет, MCP AST Explorer работает без API-ключей и переменных окружения.
MCP AST Explorer — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить MCP AST Explorer в Claude Desktop, Claude Code или Cursor?
Открой MCP AST Explorer на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectCompare MCP AST Explorer with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development