archmcp

Overview

archmcp is a local MCP server that creates architectural snapshots of repositories before AI agents begin exploring code. It exposes pre-generated architectural summaries as MCP resources and provides tools for on-demand snapshot generation and querying. The server processes code through a pipeline that walks files, extracts facts based on language-specific parsers, stores them in a graph index, and renders them as LLM-friendly context. Currently supports Go, Kotlin, Python, TypeScript, Swift, Ruby, and OpenAPI specifications with language-specific awareness for frameworks like Next.js, Android, FastAPI, Rails, and more.

Try asking AI

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

• generate_snapshot

  Generate an architectural snapshot of a repository

  Try:Generate an architectural snapshot of /path/to/my/projectTry:Create a new architectural snapshot for this repository
• query_facts

  Query architectural facts with optional filters

  Try:Query all route facts to see every API endpointTry:Show all dependencies in the authentication moduleTry:Find all cyclic dependencies in the codebase
• analyze_architecture

  Analyze architectural patterns and potential issues

  Try:Are there any layer violations in the current architecture?Try:Check for architectural issues in the codebaseTry:Analyze the dependency structure between modules
• get_insights

  Retrieve architectural insights and recommendations

  Try:Show me architectural insights for this projectTry:What are the key architectural patterns detected?Try:Get recommendations for improving the architecture
• append_snapshot

  Append another repository to the current architectural snapshot

  Try:Append the frontend repository to the current snapshotTry:Add the service repository to analyze together with the frontend
• get_dependencies

  Get dependency information for a specific module or symbol

  Try:Show all dependencies for the authentication moduleTry:What does the config module transitively depend on?Try:Get the full dependency graph for the payment service
• get_symbols

  Retrieve all symbols (classes, functions, etc.) in the codebase

  Try:Show all symbols in the user moduleTry:List all API endpoints defined in the codeTry:Find all view components in the frontend
• impact_analysis

  Analyze the impact of changing a specific module or symbol

  Try:What would break if I refactor the internal/server module?Try:Show impact analysis of changing the user modelTry:What components are affected by modifying the payment API?
• get_routes

  Get all API routes and their handlers

  Try:Show all API endpoints and their handlersTry:List all routes in the applicationTry:What routes are defined in the config/routes.rb file?
• get_call_chain

  Get the call chain between two symbols

  Try:Show me the call chain from main to handleRequestTry:What is the path from the controller to the database?Try:Trace the flow from the UI to the backend service
• get_storage

  Get database/storage models and their relationships

  Try:Show all database models and their relationshipsTry:What storage models are defined in the code?Try:List all entities in the system
• get_layer_violations

  Check for architectural layer violations

  Try:Check for layer violations in the current architectureTry:Are there any improper dependencies between layers?Try:Find any violations of the layered architecture pattern

Comparable tools

Installation

go build -o archmcp ./cmd/archmcp

go install ./cmd/archmcp

{
  "mcpServers": {
    "archmcp": {
      "command": "/path/to/archmcp",
      "args": ["/path/to/mcp-arch.yaml"]
    }
  }
}

{
  "mcpServers": {
    "archmcp": {
      "command": "archmcp"
    }
  }
}

FAQ

What is archmcp?

archmcp is an MCP server that generates architectural snapshots of repositories, providing AI agents with structured overviews of modules, symbols, dependencies, and patterns before they start exploring code.

Does archmcp replace traditional code exploration tools?

No, archmcp is designed to run before traditional tools. It provides upfront structural context that makes tools like grep, file search, and code reading more effective by helping the AI know where to look.

Compare archmcp with