project-advisors-mcp
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Android projects, typically written in Kotlin.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in iOS projects, typically written in Swift.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Kotlin projects, including Android apps.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Node.js projects.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Python projects.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Rust projects.
Provides diagnostic tools for analyzing architecture, security, REST API compliance, and dependencies in Swift projects, including iOS apps.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@project-advisors-mcp Run a security scan on this project and report vulnerabilities."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Project Advisors MCP Server
An MCP (Model Context Protocol) server providing diagnostic tools to analyze software architecture, security, REST API compliance, and dependencies.
Supports: Python, Rust, Go, Node.js, Java, Swift (iOS), and Kotlin (Android).
Inspiration: The design and concept of these diagnostic advisors were heavily inspired by the BootUI platform.
Setup
npm install
npm run buildRelated MCP server: arch-optimize
Running the Server
The server runs via stdio:
npm startAvailable Tools
run_architecture_scanrun_rest_api_scanrun_security_scanrun_vulnerability_scanrun_pentest_scanget_telemetry_streamrun_mcp_design_scan
Using the Agent Skill
This project includes a custom AI Agent Skill located at .agents/skills/project-advisor/SKILL.md. Agents like Antigravity will automatically use it when you ask them to "audit codebase" or "give project health score".
How to use this MCP Server
To use this library with your AI Coding Assistant, you need to configure the assistant to spawn this server via its stdio transport mechanism.
1. Claude Desktop Configuration
Add the following to your Claude Desktop config file (e.g. ~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
"mcpServers": {
"project-advisors": {
"command": "node",
"args": ["/Users/ragu/Code/project-advisors/dist/index.js"]
}
}
}Note: Make sure to run npm run build first so the dist/index.js file exists, and update the absolute path to point to your repository.
2. Cursor IDE Configuration
Open Cursor Settings -> Features -> MCP.
Click + Add new MCP server.
Set the Name to
project-advisors.Set the Type to
command.Set the Command to
node /absolute/path/to/project-advisors/dist/index.js.Click Save.
3. Example AI Prompts
Once connected, you can ask your AI Agent to run audits on your current workspace:
"Run an architecture scan on this project and tell me if there are any boundary violations."
"Check my REST APIs for compliance and security issues."
"Give me an overall health score for this project using the project advisor tools."
Available Tools
7 toolsget_telemetry_streamA
Retrieves live runtime activity (memory usage, unhandled exceptions, slow queries, leak traces) received from JVM or mobile sidecar streams.
Inputs: limit, severity.
run_architecture_scanB
Scans workspace source files for layer boundary violations, circular dependencies, and improper coupling. Supports Python, Rust, Go, Node.js, Java, Swift (iOS), and Kotlin (Android).
Inputs: pattern, projectRoot.
run_mcp_design_scanA
Verifies the design and implementation of MCP (Model Context Protocol) servers. Checks for proper tool definitions, schema validation, transport security, and proper error handling.
Inputs: strictMode, projectRoot.
run_pentest_scanA
Generates non-destructive exploit payloads (SQLi, XSS, JWT tampering) against configured dev environment endpoints to test input sanitization.
Inputs: targetUrl (required), payloadTypes.
run_rest_api_scanB
Evaluates REST endpoints/controllers for HTTP compliance, missing pagination, state-mutating GETs, raw stack traces, and unvalidated payloads.
Inputs: strictMode, includeRoutes.
run_security_scanB
Audits security configurations, hardcoded secrets/API keys, exposed management endpoints, missing CSRF tokens, and insecure permissions.
Inputs: scanConfig, scanSecrets.
run_vulnerability_scanB
Checks build dependency files (package.json, pom.xml, build.gradle, Cargo.toml, requirements.txt, etc.) against known CVE databases.
Inputs: manifestPath.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct concern (dependencies, endpoints, runtime telemetry, MCP design, architecture, REST APIs, security config), but some overlap exists between security scan, vulnerability scan, and pentest scan. Descriptions clarify boundaries, so misselection is unlikely but possible.
Six of seven tools follow the 'run_*_scan' pattern, which is predictable and consistent. The outlier 'get_telemetry_stream' uses a different verb and noun style, creating a minor deviation but not causing confusion.
Seven tools is well within the ideal range for a specialized scanning server. Each tool covers a distinct aspect of project advisory, and the count feels neither sparse nor bloated.
The tool surface covers the main advisory domains: dependencies, security config, architecture, REST APIs, and runtime telemetry. Minor gaps like container scanning or infrastructure checks exist, but the core workflows are well covered.
Related MCP Connectors
Zero-config MCP security scanner for AI-generated apps. 25K+ vulnerability patterns.
Scan AI agent skills, MCP server packages and MCP configs before you install them. Static analysis.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for secureFlows: token-free URL builders and integration-linting tools for AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that integrates SAST, DAST, and SCA security tools to enable AI-driven vulnerability scanning and automated security reporting. It allows AI assistants to execute and analyze results from tools like Semgrep, OWASP ZAP, and Trivy within a DevSecOps workflow.6MIT
- AlicenseNot gradedqualityBmaintenanceMCP server that provides tools for architecture analysis, risk diagnosis, quality metrics, and regression guarding to support AI-driven code review and incremental refactoring workflows.5MIT
- AlicenseAqualityCmaintenanceMCP server that provides audit and safety-check tools for enterprise SDLC code integrity, enabling AI agents to scan workspaces for lifecycle gaps, mock-theater tests, DRY violations, and language-specific issues in shell, JavaScript/HTML, and Python.414 npmMIT
- AlicenseAqualityBmaintenanceMCP server that enables AI coding assistants to audit repositories against engineering rules, generating self-contained HTML reports with citations and optional GitHub issue filing.102Apache 2.0