Axon.MCP.Server

Overview

Axon.MCP.Server is a comprehensive Model Context Protocol implementation that enables AI assistants to deeply understand codebases beyond simple syntax parsing. It combines Tree-sitter for multi-language syntax analysis with Roslyn for C# semantic understanding, creating detailed call graphs, inheritance hierarchies, and dependency networks. The system uses vector embeddings for semantic code search and can automatically detect services, APIs, Entity Framework mappings, and design patterns. It features a 10-service microarchitecture with production-grade observability through Prometheus and Grafana dashboards, along with enterprise security features including JWT authentication and RBAC.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• search

  Semantic + full-text code search

  Try:Find all authentication controllersTry:Search for functions handling user registration
• get_call_graph

  Function call relationships

  Try:Who calls UserService.CreateUser?Try:Show all functions calling PaymentProcessor
• get_inheritance_hierarchy

  Class inheritance tree

  Try:Show me all BaseController implementationsTry:Display inheritance chain for Exception classes
• get_api_endpoints

  List REST API routes

  Try:What endpoints modify the User table?Try:Find all GET endpoints in the API
• get_ef_entities

  Entity Framework mappings

  Try:Show database schema for OrdersTry:List all Entity Framework entities
• get_module_summary

  AI-generated code summaries

  Try:Explain what PaymentService doesTry:Summarize the Auth module
• explore_service

  Navigate service architecture

  Try:Show me the API service structureTry:Explore the billing service architecture
• find_implementations

  Interface implementations

  Try:Find all IRepository implementationsTry:Show implementations of IValidatableObject
• get_system_architecture_map

  Generate architecture diagrams

  Try:Visualize system dependenciesTry:Create service architecture diagram
• get_symbol_details

  Detailed symbol info

  Try:Show UserController.Login signatureTry:Get details for OrderProcessor.Process method
• get_file_symbols

  List symbols in a file

  Try:What's in AuthService.cs?Try:Show all functions in PaymentProcessor.py
• get_repository_structure

  Project/solution organization

  Try:Show .NET solution structureTry:Display repository folder organization

Comparable tools

Installation

# Clone the repository
git clone https://github.com/ali-kamali/Axon.MCP.Server.git
cd axon.mcp.server

# Copy environment template
cp .env.example .env

# Edit .env with your credentials
# Set GITLAB_TOKEN or AZUREDEVOPS_PASSWORD
# Set ADMIN_API_KEY and ADMIN_PASSWORD

# Start all services
make docker-up

# Run database migrations
make migrate

{
  "mcpServers": {
    "axon": {
      "command": "python",
      "args": ["-m", "uvicorn", "axon_mcp_server.main:app", "--host", "0.0.0.0", "--port", "8001"],
      "env": {
        "AXON_ADMIN_API_KEY": "your-api-key"
      }
    }
  }
}

FAQ

What programming languages does Axon support?

Axon supports deep analysis for C# (with Roslyn), Python, JavaScript, and TypeScript. It can parse other languages with Tree-sitter but provides more detailed analysis for the primary four.

How does Axon handle large codebases?

Axon is designed for performance with <500ms p95 latency and can handle 10,000+ files. It uses smart caching, parallel processing with Celery workers, and PostgreSQL with pgvector for efficient storage and retrieval.

Compare Axon.MCP.Server with