Skip to content
Back to search

Axon.MCP.Server

Transform your codebase into an intelligent knowledge base for AI-powered development with Cursor IDE, Google AntiGravity, and MCP-enabled assistants

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ali-kamali--axon-mcp-server/badge.svg)](/listings/ali-kamali--axon-mcp-server)

HTML

<a href="/listings/ali-kamali--axon-mcp-server"><img src="/api/listings/ali-kamali--axon-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Get up and running in **5 minutes** with Docker Compose.

Prerequisites

- ๐Ÿณ Docker & Docker Compose installed - ๐Ÿ Python 3.11+ (for local development) - ๐Ÿ”‘ GitLab or Azure DevOps access token

Step 1: Clone & Configure

# 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:**

# Source control (choose one)
GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx
# OR
AZUREDEVOPS_PASSWORD=your-azure-devops-pat

# Security (generate strong keys)
ADMIN_API_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
ADMIN_PASSWORD=your-secure-password

# Optional: AI enrichment (for LLM-generated code summaries)
OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx

Step 2: Launch Services


# Start all services (PostgreSQL, Redis, API, Workers, UI, Monitoring)
make docker-up

# Run database migrations
make migrate

# Verify health
curl http://localhost:8080/api/v1/health
# โœ… Expected: {"status":"ok"}

Step 3: Access Your Platform

| ๐ŸŽฏ Service | ๐ŸŒ URL | ๐Ÿ” Credentials | |------------|--------|----------------| | **React Dashboard** | [http://localhost:80](http://localhost:80) | Login with `ADMIN_PASSWORD` | | **REST API Docs** | [http://localhost:8080/api/docs](http://localhost:8080/api/docs) | `X-API-Key: ADMIN_API_KEY` | | **MCP Server** | `http://localhost:8001` | For AI assistants (see [MCP Tools](docs/api/mcp_tools.md)) | | **Grafana** | [http://localhost:3000](http://localhost:3000) | `admin / admin` | | **Prometheus** | [http://localhost:9090](http://localhost:9090) | No auth |

๐ŸŽ‰ You're Ready!

**Next Steps:** 1. ๐Ÿ“Š View the React Dashboard and add your first repository 2. ๐Ÿ” Try a semantic search: "Find all authentication controllers" 3. ๐Ÿค– Connect an AI assistant using the MCP server 4. ๐Ÿ“ˆ Monitor performance in Grafana dashboards

> **๐Ÿ’ก Pro Tip:** Check out the [Development Guide](docs/guides/development.md) for local development setup and testing.

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md ยท README ยท 500 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <!-- Banner Placeholder - Replace with actual logo/banner image -->
  3. <img src="assets/axon-mcp-banner.png" alt="Axon MCP Server Banner" width="800"/>
  4. # Axon.MCP.Server
  5. **Model Context Protocol (MCP) Server for AI IDEs - Cursor, AntiGravity & Claude**
  6. *Transform your codebase into an intelligent knowledge base for AI-powered development with Cursor IDE, Google AntiGravity, and MCP-enabled assistants*
  7. ---
  8. [![Python Version](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
  9. [![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](LICENSE)
  10. [![Commercial License](https://img.shields.io/badge/License-Commercial_Available-purple.svg)](#-license--commercial-use)
  11. [![Build Status](https://github.com/ali-kamali/Axon.MCP.Server/actions/workflows/ci.yml/badge.svg?branch=public-release)](https://github.com/ali-kamali/Axon.MCP.Server/actions/workflows/ci.yml)
  12. [![Docker Image](https://img.shields.io/badge/docker-GHCR-blue.svg)](https://github.com/ali-kamali/Axon.MCP.Server/pkgs/container/axon-mcp-server)
  13. [![Coverage](https://img.shields.io/badge/coverage-85%25-yellowgreen.svg)]()
  14. [![MCP Protocol](https://img.shields.io/badge/MCP-v1.0-purple.svg)](https://modelcontextprotocol.io)
  15. [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://ali-kamali.github.io/Axon.MCP.Server/)
  16. [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)]()
  17. </div>
  18. ---
  19. ## ๐Ÿ“‹ Table of Contents
  20. - [The Problem](#-the-problem)
  21. - [The Solution](#-the-solution)
  22. - [See It In Action](#-see-it-in-action)
  23. - [Architecture Overview](#๏ธ-architecture-overview)
  24. - [MCP Tools for AI Assistants](#-mcp-tools-for-ai-assistants)
  25. - [Key Features](#-key-features)
  26. - [Quick Start](#-quick-start)
  27. - [Use Cases](#-use-cases)
  28. - [Documentation](#-documentation)
  29. - [Development](#-development)
  30. - [Roadmap](#๏ธ-roadmap)
  31. - [Contributing](#-contributing)
  32. - [License](#-license)
  33. ---
  34. ## ๐ŸŽฏ The Problem
  35. Modern codebases are complex labyrinthsโ€”thousands of files, intricate dependencies, and evolving architectures. **AI assistants like ChatGPT and Claude are brilliant... but they're flying blind.** Without deep understanding of your codebase's structure, relationships, and patterns, they can only see the trees, never the forest.
  36. ## ๐Ÿ’ก The Solution
  37. **Axon.MCP.Server** transforms your entire codebase into an intelligent, queryable knowledge base using the **Model Context Protocol (MCP)**. Think of it as giving your AI assistant X-ray vision into your codeโ€”understanding not just syntax, but semantics, architecture, and relationships.
  38. ### Why Axon Stands Out
  39. - **๐Ÿง  Semantic Understanding**: Goes beyond grep to understand what code *means*, not just what it says
  40. - **๐Ÿ”— Relationship Mapping**: Automatically builds call graphs, inheritance trees, and dependency networks
  41. - **๐Ÿค– AI-Native Integration**: Built specifically for ChatGPT, Claude, Cursor IDE, and other MCP-enabled tools
  42. - **๐Ÿ“Š Multi-Language Mastery**: Deep analysis for C# (Roslyn), Python, JavaScript, TypeScript
  43. - **๐Ÿ” Vector-Powered Search**: Find code by meaning using semantic embeddings
  44. - **๐Ÿ—๏ธ Architecture Intelligence**: Auto-detects services, APIs, Entity Framework mappings, design patterns
  45. - **โšก Production-Ready Performance**: <500ms p95 latency, handles 10,000+ files with ease
  46. - **๐Ÿ” Enterprise Security**: JWT auth, RBAC, audit logging, rate limitingโ€”not a toy project
  47. ---
  48. ## ๏ฟฝ See It In Action
  49. <div align="center">
  50. ### ๐Ÿค– AI IDE Integration - The Main Use Case
  51. **Axon MCP Server seamlessly integrates with leading AI-powered IDEs to supercharge your development workflow**
  52. #### Google AntiGravity - Best AI IDE for Vibe Coders
  53. ![AntiGravity Integration](assets/screenshots/AntiGravity.png)
  54. *Axon MCP providing deep code context to Google AntiGravity for intelligent code assistance*
  55. #### Cursor IDE - AI-First Code Editor
  56. ![Cursor Integration](assets/screenshots/Cursor.png)
  57. *Real-time code intelligence powered by Axon's semantic understanding in Cursor*
  58. ---
  59. ### ๐Ÿ›๏ธ Management Dashboard
  60. ![Axon Dashboard](assets/screenshots/dashboard.png)
  61. *Real-time monitoring of code analysis and synchronization*
  62. ### ๐Ÿ› ๏ธ Architecture Visualization
  63. ![Architecture Map](assets/architecture-diagram.jpg)
  64. *Auto-generated service dependency diagrams*
  65. </div>
  66. ---
  67. ## ๐Ÿ—๏ธ Architecture Overview
  68. ### 10-Service Microarchitecture
  69. ```
  70. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  71. โ”‚ Client Layer: AI Assistants, IDEs, React UI, REST Clients โ”‚
  72. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  73. โ”‚
  74. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  75. โ”‚ โ”‚ โ”‚
  76. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”
  77. โ”‚ MCP Server โ”‚ โ”‚ REST API โ”‚ โ”‚ React UI โ”‚
  78. โ”‚ :8001 โ”‚ โ”‚ :8080 โ”‚ โ”‚ :80 โ”‚
  79. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  80. โ”‚ โ”‚
  81. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  82. โ”‚ โ”‚ โ”‚ โ”‚
  83. โ”‚ โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ” โ”Œโ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  84. โ”‚ โ”‚ Worker โ”‚ โ”‚ Beat โ”‚ โ”‚ Enrichmentโ”‚
  85. โ”‚ โ”‚ (Sync) โ”‚ โ”‚ Schedโ”‚ โ”‚ Worker โ”‚
  86. โ”‚ โ””โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”˜
  87. โ”‚ โ”‚ โ”‚
  88. โ”Œโ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”
  89. โ”‚ Analysis: Tree-sitter + Roslyn + EF โ”‚
  90. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  91. โ”‚
  92. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  93. โ”‚ โ”‚ โ”‚
  94. โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
  95. โ”‚ PostgreSQL โ”‚ โ”‚ Redis โ”‚ โ”‚ Prometheus + โ”‚
  96. โ”‚ + pgvector โ”‚ โ”‚ Cache โ”‚ โ”‚ Grafana โ”‚
  97. โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  98. ```
  99. ### Technology Stack
  100. **Backend**: FastAPI, Celery, SQLAlchemy 2.0 (async), Python 3.11+
  101. **Parsing**: Tree-sitter (multi-lang), Roslyn (C# semantic analysis)
  102. **Database**: PostgreSQL 15 + pgvector, Redis
  103. **AI/ML**: OpenAI/OpenRouter (LLM), sentence-transformers (embeddings)
  104. **Frontend**: React + TypeScript, Vite
  105. **Infrastructure**: Docker Compose, Prometheus, Grafana
  106. ---
  107. ## ๐Ÿ”Œ MCP Tools for AI Assistants
  108. The server exposes **12 powerful tools** to AI assistants via the Model Context Protocol:
  109. | Tool | Description | Use Case |
  110. |------|-------------|----------|
  111. | `search` | Semantic + full-text code search | "Find all authentication controllers" |
  112. | `get_call_graph` | Function call relationships | "Who calls UserService.CreateUser?" |
  113. | `get_inheritance_hierarchy` | Class inheritance tree | "Show me all BaseController implementations" |
  114. | `get_api_endpoints` | List REST API routes | "What endpoints modify the User table?" |
  115. | `get_ef_entities` | Entity Framework mappings | "Show database schema for Orders" |
  116. | `get_module_summary` | AI-generated code summaries | "Explain what PaymentService does" |
  117. | `explore_service` | Navigate service architecture | "Show me the API service structure" |
  118. | `find_implementations` | Interface implementations | "Find all IRepository implementations" |
  119. | `get_system_architecture_map` | Generate architecture diagrams | "Visualize system dependencies" |
  120. | `get_symbol_details` | Detailed symbol info | "Show UserController.Login signature" |
  121. | `get_file_symbols` | List symbols in a file | "What's in AuthService.cs?" |
  122. | `get_repository_structure` | Project/solution organization | "Show .NET solution structure" |
  123. ---
  124. ## โœจ Key Features
  125. ### ๐Ÿ”ฌ 1. Hybrid Python/C# Analysis Engine
  126. - **Tree-sitter**: Lightning-fast syntactic parsing for Python, JavaScript, TypeScript, and C#
  127. - **Roslyn Subprocess**: Compiler-grade semantic analysis for C# (type resolution, cross-file references, metadata)
  128. - **EF Core Analyzer**: Extracts Entity Framework entities, table mappings, and relationships automatically
  129. ### ๐Ÿ—‚๏ธ 2. Intelligent Code Indexing
  130. - ๐Ÿ”„ Automatically discovers repositories from GitLab/Azure DevOps
  131. - ๐Ÿท๏ธ Extracts symbols (classes, functions, variables) with rich metadata (docstrings, parameters, return types)
  132. - ๐Ÿ“ž Builds call graphs, inheritance hierarchies, and import dependency maps
  133. - ๐Ÿ—๏ธ Detects services, APIs, workers, and libraries with auto-classification
  134. - ๐Ÿงฎ Generates vector embeddings for semantic search powered by pgvector
  135. ### ๐Ÿค– 3. AI-Powered Enrichment
  136. - ๐Ÿ“ LLM-generated summaries for symbols and modules (using OpenRouter/OpenAI)
  137. - โšก Parallel processing with 8-worker Celery pipeline for blazing speed
  138. - ๐Ÿ’พ Smart caching to avoid re-generation and reduce API costs
  139. ### ๐Ÿ“Š 4. Production-Grade Observability
  140. - ๐Ÿ“ˆ Pre-configured Prometheus metrics (API latency, sync status, search performance, cache hit rates)
  141. - ๐Ÿ“‰ Beautiful Grafana dashboards for real-time monitoring
  142. - ๐Ÿ“„ Structured JSON logging with `structlog` for easy parsing
  143. - ๐Ÿ“ก Real-time sync progress via Redis Pub/Sub for responsive UI updates
  144. ### ๐Ÿ” 5. Enterprise Security
  145. - ๐Ÿ”‘ JWT authentication + API keys for flexible auth strategies
  146. - ๐Ÿ‘ฅ Role-based access control (admin, readonly) for granular permissions
  147. - ๐Ÿช HTTP-only cookies with CSRF protection
  148. - โฑ๏ธ Rate limiting and comprehensive audit logging
  149. ---
  150. ## ๐Ÿ“Š Data Model Highlights
  151. The system maintains a rich relational model:
  152. - **Repositories**: Source control repos (GitLab/Azure DevOps)
  153. - **Files**: Source code files with content hashes
  154. - **Symbols**: Functions, classes, variables with AI enrichment
  155. - **Relations**: Inherits, implements, calls, references, imports
  156. - **Services**: Detected APIs, workers, libraries
  157. - **EfEntities**: Entity Framework โ†’ database table mappings
  158. - **Embeddings**: pgvector embeddings for semantic search
  159. - **Chunks**: Code chunks (function/class level) for RAG
  160. **Total Tables**: 14 with optimized indexes, cascading deletes, unique constraints
  161. ---
  162. ## ๐Ÿš€ Quick Start
  163. Get up and running in **5 minutes** with Docker Compose.
  164. ### Prerequisites
  165. - ๐Ÿณ Docker & Docker Compose installed
  166. - ๐Ÿ Python 3.11+ (for local development)
  167. - ๐Ÿ”‘ GitLab or Azure DevOps access token
  168. ### Step 1: Clone & Configure
  169. ```bash
  170. # Clone the repository
  171. git clone https://github.com/ali-kamali/Axon.MCP.Server.git
  172. cd axon.mcp.server
  173. # Copy environment template
  174. cp .env.example .env
  175. ```
  176. **Edit `.env` with your credentials:**
  177. ```bash
  178. # Source control (choose one)
  179. GITLAB_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx
  180. # OR
  181. AZUREDEVOPS_PASSWORD=your-azure-devops-pat
  182. # Security (generate strong keys)
  183. ADMIN_API_KEY=$(python -c "import secrets; print(secrets.token_urlsafe(32))")
  184. ADMIN_PASSWORD=your-secure-password
  185. # Optional: AI enrichment (for LLM-generated code summaries)
  186. OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxx
  187. ```
  188. ### Step 2: Launch Services
  189. ```bash
  190. # Start all services (PostgreSQL, Redis, API, Workers, UI, Monitoring)
  191. make docker-up
  192. # Run database migrations
  193. make migrate
  194. # Verify health
  195. curl http://localhost:8080/api/v1/health
  196. # โœ… Expected: {"status":"ok"}
  197. ```
  198. ### Step 3: Access Your Platform
  199. | ๐ŸŽฏ Service | ๐ŸŒ URL | ๐Ÿ” Credentials |
  200. |------------|--------|----------------|
  201. | **React Dashboard** | [http://localhost:80](http://localhost:80) | Login with `ADMIN_PASSWORD` |
  202. | **REST API Docs** | [http://localhost:8080/api/docs](http://localhost:8080/api/docs) | `X-API-Key: ADMIN_API_KEY` |
  203. | **MCP Server** | `http://localhost:8001` | For AI assistants (see [MCP Tools](docs/api/mcp_tools.md)) |
  204. | **Grafana** | [http://localhost:3000](http://localhost:3000) | `admin / admin` |
  205. | **Prometheus** | [http://localhost:9090](http://localhost:9090) | No auth |
  206. ### ๐ŸŽ‰ You're Ready!
  207. **Next Steps:**
  208. 1. ๐Ÿ“Š View the React Dashboard and add your first repository
  209. 2. ๐Ÿ” Try a semantic search: "Find all authentication controllers"
  210. 3. ๐Ÿค– Connect an AI assistant using the MCP server
  211. 4. ๐Ÿ“ˆ Monitor performance in Grafana dashboards
  212. > **๐Ÿ’ก Pro Tip:** Check out the [Development Guide](docs/guides/development.md) for local development setup and testing.
  213. ---
  214. ## ๐ŸŽฏ Use Cases
  215. ### ๐Ÿš€ Primary: AI IDE Integration (Cursor, AntiGravity, VS Code)
  216. **The main purpose of Axon MCP Server is to provide deep code intelligence to AI-powered IDEs:**
  217. #### Cursor IDE
  218. 1. **Contextual Code Completion**: AI understands your entire codebase structure
  219. 2. **Intelligent Chat**: Ask questions about architecture, dependencies, and implementation details
  220. 3. **Semantic Code Search**: Find code by what it does, not just what it's called
  221. 4. **Refactoring Assistance**: AI knows all usages across your entire codebase
  222. #### Google AntiGravity
  223. 1. **Vibe Coding Intelligence**: Deep understanding of code patterns and architecture
  224. 2. **Cross-Repository Context**: Work with multiple projects seamlessly
  225. 3. **Smart Code Generation**: AI suggestions based on your actual codebase patterns
  226. 4. **Real-Time Documentation**: Instant explanations of complex code sections
  227. #### Other MCP-Enabled Tools
  228. - **Claude Desktop**: Ask natural language questions about your codebase
  229. - **ChatGPT with MCP**: Deep code analysis and architectural insights
  230. - **Custom MCP Clients**: Build your own AI-powered dev tools
  231. ### ๐Ÿ“Š For Development Teams
  232. 1. **Onboarding**: New developers can ask "How does authentication work?" and get comprehensive answers
  233. 2. **Code Review**: AI-assisted review with full context of dependencies and impacts
  234. 3. **Documentation**: Auto-generated explanations for complex modules
  235. 4. **Impact Analysis**: "What breaks if I change this API?" with complete dependency traces
  236. ### ๐Ÿ” For Software Architects
  237. 1. **Architecture Visualization**: Auto-generated service dependency diagrams
  238. 2. **Design Pattern Detection**: Identify patterns and anti-patterns across the codebase
  239. 3. **Technical Debt Analysis**: Find complex, tightly-coupled code sections
  240. 4. **Migration Planning**: Understand all dependencies before major refactors
  241. ---
  242. ## ๐Ÿ“š Documentation
  243. ### ๐Ÿ— Architecture
  244. - [Overview](https://ali-kamali.github.io/Axon.MCP.Server/architecture/overview/) - System architecture and core components
  245. - [Data Models](https://ali-kamali.github.io/Axon.MCP.Server/architecture/data_models/) - Database schema and relationships
  246. - [Infrastructure](https://ali-kamali.github.io/Axon.MCP.Server/architecture/infrastructure/) - Deployment and scaling
  247. ### ๐Ÿ“– Guides
  248. - [Setup Guide](https://ali-kamali.github.io/Axon.MCP.Server/guides/setup/) - Prerequisites and installation
  249. - [Development Guide](https://ali-kamali.github.io/Axon.MCP.Server/guides/development/) - Dev environment setup and testing
  250. - [Deployment Guide](https://ali-kamali.github.io/Axon.MCP.Server/guides/deployment/) - Docker and Kubernetes deployment
  251. - [Security Guide](https://ali-kamali.github.io/Axon.MCP.Server/guides/security/) - Security features and best practices
  252. ### ๐Ÿ”Œ API & Tools
  253. - [REST API Reference](https://ali-kamali.github.io/Axon.MCP.Server/api/rest_api/) - API endpoints and usage
  254. - [MCP Tools Reference](https://ali-kamali.github.io/Axon.MCP.Server/api/mcp_tools/) - MCP tools for AI assistants
  255. ### โš™๏ธ Reference
  256. - [Configuration](docs/reference/configuration.md) - Environment variables
  257. - [Troubleshooting](docs/reference/troubleshooting.md) - Common issues and solutions
  258. ---
  259. ## ๐Ÿ”ง Development
  260. ```bash
  261. # Install dependencies
  262. make dev-install
  263. # Run tests
  264. make test
  265. # Start API (dev mode with hot reload)
  266. make api-dev
  267. # Start MCP server
  268. make mcp-dev
  269. # Start UI
  270. make ui-dev
  271. # Lint and format
  272. make lint
  273. make format
  274. ```
  275. ---
  276. ## ๐ŸŒŸ What Makes This Special?
  277. 1. **Hybrid Intelligence**: Syntactic (Tree-sitter) + Semantic (Roslyn) analysis
  278. 2. **AI-First Design**: Built specifically to feed AI assistants with code context
  279. 3. **Production-Grade**: Real auth, monitoring, distributed processing, caching
  280. 4. **Multi-Source**: Supports GitLab and Azure DevOps
  281. 5. **Deep C# Support**: Compiler-grade analysis via Roslyn
  282. 6. **Semantic Search**: Vector embeddings enable "find similar code" queries
  283. 7. **Architectural Awareness**: Detects services, APIs, entitiesโ€”not just functions
  284. ---
  285. ## ๐Ÿ—บ๏ธ Roadmap
  286. This project is **actively maintained** and continuously evolving. Here's what's on our horizon:
  287. ### โœ… Completed (v3.2 - Current)
  288. - [x] **API Authentication**: JWT tokens + API keys for hybrid auth scenarios
  289. - [x] **Hybrid Authentication**: UI login with cookies + programmatic API key access
  290. - [x] **Memory Optimization**: Keyset pagination for efficient large dataset handling
  291. - [x] **Vector Search**: Semantic code search powered by pgvector embeddings
  292. - [x] **Multi-Language Support**: Python, JavaScript, TypeScript, C# (via Roslyn)
  293. ### ๐Ÿšง In Progress (v3.2 โ†’ v3.3)
  294. - [ ] **Roslyn Process Manager Refactor**: Improved stability and resource management
  295. - [ ] **Pipeline Pattern Refactor**: More modular and testable processing architecture
  296. ### ๐ŸŽฏ Next Release (v3.3 - Q1 2026)
  297. - [ ] **RAG Pipeline**: Ask natural language questions about your codebase ("How does auth work?")
  298. - [ ] **Architecture Visualization**: Auto-generate Mermaid/PlantUML diagrams from code structure
  299. - [ ] **Impact Analysis Tool**: See what breaks before you change it ("What depends on UserService?")
  300. - [ ] **Conversation Memory**: Multi-turn AI conversations with context retention
  301. ### ๐Ÿš€ Future Enhancements (v4.0+)
  302. - [ ] **AI Test Generation**: Automatically generate unit tests for your code
  303. - [ ] **Code Review Assistant**: AI-powered PR reviews with security and quality checks
  304. - [ ] **Complexity Heatmaps**: Visual complexity analysis to identify refactoring candidates
  305. - [ ] **Dependency Audit**: Track and visualize package dependencies and vulnerabilities
  306. - [ ] **Language Expansion**: Java, Go, Rust, Ruby, PHP support
  307. - [ ] **IDE Plugins**: Native plugins for VS Code, JetBrains IDEs
  308. - [ ] **Collaboration Features**: Team annotations, shared searches, codebase bookmarks
  309. > **๐Ÿ’ก Have a feature idea?** Open an issue on our GitLab repository!
  310. ---
  311. ## ๐Ÿ“„ License & Commercial Use
  312. **Axon.MCP.Server** is dual-licensed to ensure sustainability and rapid development.
  313. ### 1. Open Source (AGPLv3)
  314. This project is free software under the **GNU Affero General Public License v3.0 (AGPLv3)**.
  315. * **Best for:** Open-source projects, hobbyists, researchers, and educational use.
  316. * **The Rule:** If you modify this code or use it in a service accessible over a network, you **must** open-source your own project under the same AGPLv3 license.
  317. * **Details:** See the [LICENSE](LICENSE) file for complete terms.
  318. ### 2. Commercial License (Enterprise)
  319. Want to integrate Axon into a proprietary/closed-source product?
  320. * **Best for:** Startups, Enterprises, and SaaS products who cannot open-source their code.
  321. * **Benefits:**
  322. * Release your product under your own proprietary license
  323. * No requirement to share your source code
  324. * Priority support and direct access to the maintainer
  325. * Legal indemnification options
  326. * Custom features and integrations
  327. ๐Ÿ“ฉ **[Contact us](mailto:your-email@example.com)** to acquire a commercial license.
  328. ---
  329. ### Why Dual Licensing?
  330. We believe in open source **and** sustainability. The AGPLv3 ensures the community benefits from improvements, while commercial licenses fund continued development, comprehensive testing, and enterprise features that benefit everyone.
  331. ---
  332. ## ๐Ÿค Contributing
  333. We welcome contributions from the community! Whether it's bug fixes, new features, or documentation improvements, your help makes this project better.
  334. ### 1. The "Reality" Check: CLA
  335. **Since this project is dual-licensed, we must ensure we have the legal right to distribute contributions.**
  336. Before merging any PR, we ask contributors to reply to a comment saying:
  337. > *"I hereby assign copyright of this contribution to the project maintainers and agree to the terms of the Contributor License Agreement."*
  338. ### 2. Getting Started
  339. 1. Fork the repository
  340. 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
  341. 3. Commit your changes (`git commit -m 'Add amazing feature'`)
  342. 4. Push to the branch (`git push origin feature/amazing-feature`)
  343. 5. Open a Pull Request
  344. ### 3. Guidelines
  345. * ๐Ÿ“˜ [Development Guide](docs/guides/development.md) - Setup, coding standards, and best practices
  346. * โœ… **Code Quality**: We use Black, mypy, and pylint for code quality
  347. * ๐Ÿงช **Testing**: Maintain >80% test coverage for all new code
  348. * ๐Ÿ”„ **Pull Requests**: Follow our PR template and ensure CI passes
  349. ---
  350. ## ๐Ÿ“ž Support & Community
  351. Need help or want to discuss features?
  352. - ๐Ÿ› **Bug Reports**: [GitHub Issues](https://github.com/ali-kamali/Axon.MCP.Server/issues)
  353. - ๐Ÿ“– **Documentation**: Browse the [`docs/`](docs/) directory
  354. - ๐Ÿ’ฌ **Community**: Join us on `#axon-mcp-server` (internal Slack)
  355. - โ“ **Questions**: Open a discussion or issue on GitHub
  356. ---
  357. <div align="center">
  358. **Built with โค๏ธ by the Axon DevOps Team**
  359. *Empowering developers with AI-driven code intelligence*
  360. [![Star on GitHub](https://img.shields.io/badge/โญ-Star%20Us%20on%20GitHub-orange)](https://github.com/ali-kamali/Axon.MCP.Server)
  361. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.