Axon Codebase Intelligence
Transform your codebase into an intelligent knowledge base for AI-powered development with Cursor IDE, Google AntiGravity, and MCP-enabled assistants
What is Axon Codebase Intelligence?
Axon Codebase Intelligence is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to transform your codebase into an intelligent knowledge base for ai-powered development with cursor ide, google antigravity, and mcp-enabled assistants
Transform your codebase into an intelligent knowledge base for AI-powered development with Cursor IDE, Google AntiGravity, and MCP-enabled assistants
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Transform your codebase into an intelligent knowledge base f
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx axon-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Axon Codebase Intelligence
Axon MCP Server transforms your entire codebase into an intelligent, queryable knowledge base by indexing repositories from GitLab or Azure DevOps and exposing 12 MCP tools for semantic search, call-graph traversal, inheritance hierarchies, and architecture visualization. It uses a 10-service microarchitecture backed by PostgreSQL with pgvector, Redis, and Celery workers to deliver sub-500ms search results across 10,000+ files. Developers working with Cursor IDE, Google AntiGravity, or Claude use it to give AI assistants true X-ray vision into large codebases—understanding semantics and relationships, not just syntax.
Prerequisites
- Docker and Docker Compose installed on your machine
- Python 3.11+ for local development or migration steps
- A GitLab personal access token (GITLAB_TOKEN) or Azure DevOps PAT (AZUREDEVOPS_PASSWORD)
- Optional: OpenRouter or OpenAI API key for LLM-generated code summaries
- An MCP-enabled client: Cursor IDE, Claude Desktop, or Google AntiGravity
Clone the repository and copy the environment template
Clone the Axon MCP Server repository and create your local .env file from the provided example.
git clone https://github.com/ali-kamali/Axon.MCP.Server.git
cd axon.mcp.server
cp .env.example .envConfigure environment variables
Edit the .env file with your source control credentials, a strong admin API key, admin password, and optionally an AI enrichment key for LLM-generated summaries.
# Source control — choose one
GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx
# OR
AZUREDEVOPS_PASSWORD=your-azure-devops-pat
# Security
ADMIN_API_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
ADMIN_PASSWORD=your-secure-password
# Optional: AI enrichment
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxLaunch all services with Docker Compose
Start PostgreSQL, Redis, the REST API, Celery workers, the React UI, Prometheus, and Grafana in one command. Then run database migrations.
make docker-up
make migrate
curl http://localhost:8080/api/v1/healthConnect an AI assistant to the MCP server
Point your AI IDE or Claude Desktop to the running MCP server at http://localhost:8001. Add the server config to your claude_desktop_config.json or Cursor settings.
Index your first repository
Open the React Dashboard at http://localhost:80, log in with your ADMIN_PASSWORD, and add your GitLab or Azure DevOps repository. The Celery workers will crawl, parse, and embed the code automatically.
Axon Codebase Intelligence Examples
Client configuration (Claude Desktop)
Add Axon MCP Server to Claude Desktop by pointing it at the running local HTTP endpoint.
{
"mcpServers": {
"axon-codebase": {
"command": "curl",
"args": ["-N", "-X", "POST", "http://localhost:8001/mcp"],
"env": {
"AXON_API_KEY": "your-admin-api-key"
}
}
}
}Prompts to try
These prompts map directly to Axon's 12 MCP tools for code intelligence tasks.
- "Find all authentication controllers in the codebase"
- "Who calls UserService.CreateUser and what are its callers?"
- "Show me all classes that implement IRepository"
- "What REST API endpoints modify the User table?"
- "Visualize the dependency map between services"
- "Explain what PaymentService does"Troubleshooting Axon Codebase Intelligence
Health check at /api/v1/health returns an error after docker-up
Wait 30-60 seconds for PostgreSQL to fully initialize, then run 'make migrate' before hitting the health endpoint. Check 'docker compose logs api' for startup errors.
Semantic search returns no results after adding a repository
Check the Celery worker logs ('docker compose logs worker') to confirm indexing is running. Large repos can take several minutes; monitor progress on the React Dashboard at http://localhost:80.
MCP tools return authentication errors in Cursor or Claude
Ensure the ADMIN_API_KEY value in .env matches what you pass in your MCP client config. The MCP server runs on port 8001, not the REST API port 8080.
Frequently Asked Questions about Axon Codebase Intelligence
What is Axon Codebase Intelligence?
Axon Codebase Intelligence is a Model Context Protocol (MCP) server that transform your codebase into an intelligent knowledge base for ai-powered development with cursor ide, google antigravity, and mcp-enabled assistants It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Axon Codebase Intelligence?
Follow the installation instructions on the Axon Codebase Intelligence GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Axon Codebase Intelligence?
Axon Codebase Intelligence works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Axon Codebase Intelligence free to use?
Yes, Axon Codebase Intelligence is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Axon Codebase Intelligence Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Axon Codebase Intelligence? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Axon Codebase Intelligence in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Axon Codebase Intelligence?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.