scc-mcp
Exposes boyter/scc code counting and complexity analysis to LLM agents via read-only tools like counting lines, finding top files, and cost estimation.
README
scc-mcp
An MCP server that exposes
boyter/scc — a fast code-counting and
complexity tool — to LLM agents.
It wraps scc in a small set of read-only tools so an agent can count lines of
code, find the largest or most complex files, break stats down by language, and
estimate project cost without learning the scc CLI.
Requirements
uvsccinstalled and on yourPATH(it is an external binary, not a Python dependency, and is not installed for you). Verify withscc --version.
Install
uv sync
Run
The server speaks MCP over stdio:
uv run scc-mcp
Tools
All tools are read-only. They default to scanning the current working directory
and return human-readable markdown, or structured JSON when
response_format: "json" is passed. Most accept include/exclude extension and
directory filters.
| Tool | Description |
|---|---|
scc_count_lines |
CLOC (code/comment/blank/lines) per language, plus totals. |
scc_top_files |
Top N files sorted by a metric (code, complexity, lines, ...). |
scc_by_extension |
CLOC broken down per language/extension. |
scc_complexity_hotspots |
Files ranked by cyclomatic complexity (refactor targets). |
scc_cost_estimate |
COCOMO cost / schedule / people estimate. |
scc_file_metrics |
Detailed per-file metrics for a file or filtered subset. |
scc_list_languages |
Languages scc recognizes and their file extensions. |
Use with opencode
This repo registers the server as a local MCP in opencode.json:
{
"mcp": {
"scc": {
"type": "local",
"command": ["uv", "run", "scc-mcp"],
"enabled": true
}
}
}
For other MCP clients, point them at the same uv run scc-mcp command (stdio
transport).
Development
uv run pytest # run the test suite
make build # build sdist + wheel into dist/
Tests that shell out to scc are skipped automatically when it is not on
PATH. See AGENTS.md for module layout and conventions.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.