codescan-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
codescan-mcp
MCP server that scans your codebase for TODOs, FIXMEs, code complexity, file stats, dependency analysis, and generates a health report with a letter grade. Zero config, zero API keys.
Install
npx codescan-mcpNo config files. No API keys. Works on any local project directory.
Related MCP server: QA Radar
Tools
scan_todos — Find all TODOs, FIXMEs, HACKs
"Find all TODOs in this project"
"Show me every FIXME and HACK in my codebase"
"What TODOs are in /path/to/project?"Scans every code file, returns tag, file, line number, and text. Groups by tag type.
project_stats — Codebase statistics
"How many lines of code are in this project?"
"Show file count by language"
"What are the largest files?"Files by extension, line counts, size, directory breakdown, largest files ranked.
find_complex_files — Complexity detector
"Find files over 300 lines"
"Which files have the deepest nesting?"
"Show me complex files that need refactoring"Flags long files, deep nesting, and long functions. Configurable threshold.
check_dependencies — Dependency analysis
"How many dependencies does this project have?"
"Is there a lockfile?"
"List all npm packages this project uses"Supports: package.json, requirements.txt, pyproject.toml, go.mod, Cargo.toml.
health_report — Full health report with letter grade
"Give me a health report for this project"
"Grade this codebase"
"How healthy is this project?"Combines all analyses into a single report with an A-F grade, scores, and actionable recommendations.
Configuration
Claude Desktop / Claude Code
{
"mcpServers": {
"codescan": {
"command": "npx",
"args": ["codescan-mcp"]
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"codescan": {
"command": "npx",
"args": ["codescan-mcp"]
}
}
}Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"codescan": {
"command": "npx",
"args": ["codescan-mcp"]
}
}
}What It Scans
35+ file types: TypeScript, JavaScript, Python, Go, Rust, Java, C/C++, Ruby, PHP, Swift, Kotlin, Vue, Svelte, and more
Smart ignore: Skips node_modules, .git, dist, build, pycache, vendor, and other non-source directories
Performance: Handles projects up to 5,000 files, skips files over 500KB
Token Cost
Tool | Tokens |
scan_todos | ~550 |
project_stats | ~550 |
find_complex_files | ~550 |
check_dependencies | ~550 |
health_report | ~550 |
Total | ~2,750 |
Part of the MCP Toolkit
webcheck-mcp — Website health analysis
git-summary-mcp — Git repository intelligence
mcp-checkup — MCP setup health analyzer
dev-utils-mcp — Developer utilities
codescan-mcp — Codebase health scanner
deadlink-checker-mcp — Dead link detector
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Related MCP Connectors
Health scores for your team's frontend repos: findings, the fixes worth most points, and SBOMs.
Evaluates any GitHub repository for license risk, maintenance velocity, stars/forks, and security.
Scores your code across 12 areas, with findings, fix prompts, and re-assessment in your AI agent
Safety grade (A to F) for any public GitHub repo, in plain English, before you install it.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables scanning projects for dependency vulnerabilities, secrets, license conflicts, code quality, and git health, returning a 0-100 health score with actionable suggestions.5 npmMIT
- AlicenseNot gradedqualityDmaintenanceAnalyzes codebases to produce structured quality health reports with risk-scored modules based on git churn, test coverage, and test-to-source mapping, acting as an MCP server for AI coding agents and a standalone CLI.MIT
- AlicenseAqualityBmaintenanceChecks a code repository without running it: Safe, Works and Complete scores with an A-F grade, catching leaked keys, dangerous calls, invented or lookalike packages, broken imports and missing project files. Standard-library Python; MCP tools scan, orphans and explain.5359 PyPIMIT
- AlicenseAqualityBmaintenanceScores npm packages, PyPI packages and GitHub repositories 0-100 with an A-F grade and plain-language risks. Scans package.json, requirements.txt and lock files; no API key needed.367 npm1Apache 2.0