archmcp

概述

archmcp 是一个本地 MCP 服务器，在 AI 代理开始探索代码之前创建代码库的架构快照。它将预生成的架构摘要作为 MCP 资源暴露，并提供按需生成和查询快照的工具。服务器通过一个管道处理代码：遍历文件，基于语言特定的解析器提取事实，将它们存储在图索引中，并渲染为 LLM 友好的上下文。目前支持 Go、Kotlin、Python、TypeScript、Swift、Ruby 和 OpenAPI 规范，并对 Next.js、Android、FastAPI、Rails 等框架具有特定语言感知能力。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• generate_snapshot

  Generate an architectural snapshot of a repository

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

  Query architectural facts with optional filters

  试试:Query all route facts to see every API endpoint试试:Show all dependencies in the authentication module试试:Find all cyclic dependencies in the codebase
• analyze_architecture

  Analyze architectural patterns and potential issues

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

  Retrieve architectural insights and recommendations

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

  Append another repository to the current architectural snapshot

  试试:Append the frontend repository to the current snapshot试试:Add the service repository to analyze together with the frontend
• get_dependencies

  Get dependency information for a specific module or symbol

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

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

  试试:Show all symbols in the user module试试:List all API endpoints defined in the code试试:Find all view components in the frontend
• impact_analysis

  Analyze the impact of changing a specific module or symbol

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

  Get all API routes and their handlers

  试试:Show all API endpoints and their handlers试试:List all routes in the application试试:What routes are defined in the config/routes.rb file?
• get_call_chain

  Get the call chain between two symbols

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

  Get database/storage models and their relationships

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

  Check for architectural layer violations

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

可对比工具

安装

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

archmcp 是什么？

archmcp 是一个 MCP 服务器，为代码库生成架构快照，在 AI 代理开始探索代码之前为其提供模块、符号、依赖和模式的结构化概览。

archmcp 会取代传统的代码探索工具吗？

不会，archmcp 设计为在传统工具之前运行。它提供前置的结构化上下文，使像 grep、文件搜索和代码阅读等工具更有效，帮助 AI 知道在哪里查看。

archmcp 对比