
Understand Anything - MCP server
io.github.uamcp/ua-mcp·v1.2.16A powerful MCP server for codebase architecture analysis and automated governance.
0 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Understand Anything - MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Understand Anything - MCP tools (13)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
ua_architecture_reportGenerate a module-level architecture report from the knowledge graph. Returns a breakdown of files per directory to identify main components.
ua_dependency_reportGenerate a top-level dependency report from the knowledge graph. Identifies the most heavily depended-on files in the codebase (high fan-in).
ua_explainExplain a specific part of the codebase by retrieving its 1-hop dependencies. Call this to understand what a file imports and where it is used.
ua_find_callersFind all callers of a specific function or file up to a certain depth. Helps trace execution paths.
ua_graph_summaryGet a high-level statistical summary of the codebase knowledge graph. Returns total node and edge counts to gauge project size.
ua_impact_analysisAnalyze the downstream impact of changing a specific file. Returns a list of files that depend on it.
ua_init_rulesInitialize a starter .ua-rules.json file in the workspace if one doesn't already exist.
ua_onboarding_docGenerate an onboarding overview document for new developers. Call this first when entering a new codebase to get oriented.
ua_precheckPre-flight architectural risk check. Call this before modifying any critical systems or refactoring to estimate risk radius.
ua_rulesEvaluate architectural constraints against the current knowledge graph. Generates a full violation report.
ua_rules_checkMid-session continuous audit. Evaluate constraints to ensure recent changes haven't introduced violations.
ua_scanCheck if a knowledge graph file is present and currently loaded. Returns instructions on how to generate the graph if missing.
ua_statusCheck the operational status of the Understand-Anything MCP server. Call this to verify if the knowledge graph is successfully loaded and active.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 68 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Understand Anything - MCP compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 85/100
- higher than 70% of 48,255 servers
- Tools
- 13
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 36
- more than 26% of 12,191 servers with a package
What its tools let an agent do: 13 read
Install Understand Anything - MCP in Claude Code, Cursor or VS Code
Runs npx -y ua-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add ua-mcp -- npx -y ua-mcp
What the publisher says
From the Understand Anything - MCP repository's README, as published. We do not edit it. Read it on GitHub
Understand-Anything MCP Server
A Model Context Protocol (MCP) server that empowers your AI agents to understand your entire project architecture, and a headless CI gateway to enforce architectural rules before code is merged.
Quick Start
[!NOTE]
Prerequisite: ua-mcp is a lightweight reader that connects your AI assistant to your local Understand-Anything knowledge graph. It does not build the graph itself.
You must install the core scanner from Egonex-AI/Understand-Anything and run /understand in your project to produce the .ua/knowledge-graph.json file. Commit this file to your repository before proceeding.
Get your AI assistant hooked up with architectural context in 60 seconds. uafindcallers, uaimpactanalysis, and ua_precheck work immediately for free with no license key required!
Claude Desktop
Add this to your claudedesktopconfig.json:
{
"mcpServers": {
"understand-anything": {
"command": "npx",
"args": ["-y", "ua-mcp"],
"env": {
"UA_PROJECT_PATH": "/absolute/path/to/your/project"
}
}
}
}Cursor
- Go to Settings > Features > MCP.
- Click + Add new MCP server.
- Name: understand-anything
- Type: command
- Command: npx -y ua-mcp
- Add an environment variable: UAPROJECTPATH = /absolute/path/to/your/project
How UA-MCP compares to Understand-Anything Tool
The free upstream Understand-Anything tool is responsible for generating the local knowledge graph and performing manual local analysis. UA-MCP sits on top of this graph to provide an automated governance layer and safety net for your codebase. While the free tool is a diagnostic scanner, UA-MCP actively blocks risky merges via its CI/branch-protection gate (ua-ci) and enforces your custom .ua-rules.json architectural boundaries.
Privacy Policy
[!IMPORTANT]
Link to Privacy Policy
Data Processing Details:
- License keys and email addresses are securely stored for billing purposes.
- Purely local, no network calls: uastatus, uascan, uagraphsummary, uaexplain, uaonboarding_doc.
- Sends graph data to the backend: uaprecheck (Free and Pro), and all Pro-only tools (uarules, uacicheck, uafindcallers, uaimpactanalysis, uavalidategraph). When these tools are used, the full local graph object is sent to our backend for CI risk analysis, rule evaluation, and quota validation. All Pro-tier computation is handled remotely.
- No source code contents are transmitted, only graph metadata (file paths and import relationships). All backend graph processing is done purely in-memory per-request and is never persisted.
### Security Considerations
- UAAPIURL defaults to the official backend (https://ua-mcp-backend.onrender.com). Be extremely cautious if you change this to a custom endpoint, as the third-party backend will receive your full knowledge graph and source file paths.
- Self-Hosting: If you are self-hosting the backend, note that a PostgreSQL DATABASE_URL is required in production. SQLite is not supported for production deployments.
🚀 Features
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Understand Anything - MCP: common questions
- Is Understand Anything - MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Understand Anything - MCP safety report
- How do I install Understand Anything - MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Understand Anything - MCP need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Understand Anything - MCP maintained?
- The last commit was 108 days ago (2026-07-19). The latest release is v1.2.16.
- How does Understand Anything - MCP compare with other MCP servers?
- safety score 85/100 (higher than 70% of 48,255 servers); tools 13 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.