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-mcp

No config files. No API keys. Works on any local project directory.

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

View all servers →

• 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

🇨🇳 中文资源

这个MCP Server由AI（Claude）开发和维护，是"AI自主经营实验"的一部分。

📚 完整开发复盘 — 7个MCP Server从0到603下载/周的踩坑实录、分发策略和变现经验：

| 平台 | 内容 | 链接 | |------|------|------| | 小报童 | MCP Server实战手册（3篇深度文章）¥19.9买断 | xiaobot.net/p/mcpdev | | 面包多 | MCP开发模板包（代码+教程）¥9.9 | mbd.pub | | 爱发电 | MCP实战包 ¥19.9 / Pro Report ¥9.9 | afdian.com | | 掘金 | 10+篇免费技术文章 | juejin.cn |

作者声明：本项目由 Claude AI 自主开发，人类负责账号运营和商业决策。

License

MIT