Axon MCP
An MCP server builds a local code graph so an agent can inspect calls, dependencies and the possible impact of a function change.
- 817 ★ on the repository
- Last commit
Extended access
Why this level
- The indexer reads source code and stores a local graph; MCP calls expose selected code context to the agent.
Install
- Works in
Manual install
pip install axoniqInstalls axoniq and the axon command; requires Python 3.11 or later. Then index the selected project.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The indexer reads source code and stores a local graph; MCP calls expose selected code context to the agent.
This is third-party code. Review the repository files before installing.
What it does
Axon indexes sources into a graph of symbols and relationships. An agent can find a function by concept, inspect its callers and assess the impact of a change. Search combines text matching, vector similarity and typo tolerance. Separate tools surface potentially unreachable code and map a Git diff to affected symbols. A web dashboard lets a person explore the same data. The index lives beside the project, while a local registry tracks multiple indexed repositories.
Who it is for. For developers who need a relationship map of Python, JavaScript or TypeScript code before refactoring.
Good fit when
- Find direct and indirect consumers before changing a function signature.
- Trace execution from an entry point to a handler.
- Search a large repository by a symbol’s purpose.
- Relate branch changes to affected parts of the code during review.
Not a fit when
- Your primary language is outside the three documented parsers.
- You need a tool that repairs dependencies automatically.
- You expect a call graph alone to prove program correctness.
Example request
Find callers of the authentication function in Axon and show what to inspect before changing its return value.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
Parsers cover Python, JavaScript and TypeScript; a complete graph is not promised for other languages. Static analysis cannot resolve every call, and relationships have different confidence levels, so check reported impact against the source. In watch mode global analysis updates every 30 seconds; some graph results may still reflect old code immediately after an edit. Package 1.0.1 is classified as alpha, so test retrieval against known project functions before refactoring.
How to disable. Disable Axon in the MCP client. Use `axon clean` to remove the current project’s index, checking the selected directory before confirming.
FAQ
How many MCP tools are documented?
Seven. They cover search, context, impact, unreachable code, Git changes, repository listing and graph queries.
Can a Cypher query mutate the graph?
No. The MCP tool accepts read-only queries and rejects write keywords after stripping comments.
Does it need a model API key?
No. Parsing, graph storage and embeddings run locally without an API key.
Does the dashboard need Node.js?
No. The built dashboard ships in the Python package. Node.js is needed only to rebuild modified frontend sources.
Does Axon use Git history?
Yes. It analyzes six months of file co-changes and adds those relationships to structural dependencies.
Discussion
No questions or reviews yet.
Related
MCP serversLocal code graph for agents: an MCP server returns entry points, symbol links and change impact in one call
Indexes a codebase into a knowledge graph and gives the agent call chains, change blast radius and code search over MCP
An MCP server that builds a code graph of functions, classes, calls and routes and answers the agent's structural queries locally
An MCP server and CLI for code research: search and understand your project and all of GitHub with fewer tokens
A code-intelligence engine for agents: builds a project graph and serves symbol lookup, call chains and blast radius, saving context
A code graph built with formal methods: axiomcode impact, path and tests show an agent what an edit breaks and what to run.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Axon (this card) | yes | not required | 817 | |
| CodeGraph (Rust) | no | not required | 915 | builds a Rust-based graph with embedded SurrealDB and multiple indexing levels |
| FSKB MCP | yes | not required | 653 | FSKB MCP, bundled in LLM Tornado, indexes code directories and gives agents semantic search with local or hosted embeddings. |
| Floorplan | no | 3,801 | A plugin maps an application interactively, giving project parts, files and requests plain-language labels and connections. |
README in short
The graph uses embedded KuzuDB storage, with an optional Neo4j dependency. Branch comparison operates at symbol level, distinguishing additions, modifications and removals.