# codescene-mcp-server

Feeds your AI assistant Code Health metrics from the local codebase: complexity, nesting, technical debt. Useful when AI writes code and maintainability matters.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 72
- Author: codescene-oss
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codescene-oss/codescene-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/codescene-mcp-server

## What it does

The server runs on your machine and plugs into an assistant as a data source about code quality. The assistant asks for an analysis, the server answers with maintainability problems, complexity figures and technical debt, and those details get folded into the prompts.

Inside are Code Health tools gated by your license, plus public agent skills under `skills/` for teams that want the same workflows in their own agentic pipelines. Agent guidance files ship with it too: `AGENTS-full.md` for CodeScene Core, `AGENTS-standalone.md` for standalone licenses, `.amazonq/rules` for Amazon Q.

Authentication comes first — the server will not work without it. The `npx` route needs Node.js 18 or later. Docker is on its way out: images between October 1 and December 31, 2026 cover bug fixes only, and nothing ships after December 31, 2026.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add codescene-mcp-server -- npx -y @codescene/codehealth-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add codescene-mcp-server -- npx -y @codescene/codehealth-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "codescene-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@codescene/codehealth-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "codescene-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codescene/codehealth-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add codescene-mcp-server npx -y @codescene/codehealth-mcp
```

## When to use it
- catch technical debt that AI adds along with new code
- measure complexity and nesting before a refactor
- locate hotspots across the codebase
- get unhealthy code ready for AI refactoring
- wire code quality metrics into an agentic pipeline

## Example prompts
- Analyze Code Health for `src/parser.ts` and list the problem areas
- Find the hotspots in this repository, sorted by complexity
- Check this patch for technical debt before I commit

## Similar
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [Serena MCP: the IDE for your agent](https://affpapa.org/en/nevibecode/mcp/serena-mcp-the-ide-for-your-agent.md) — MCP server · ★ 30677
- [Repomix](https://affpapa.org/en/nevibecode/mcp/repomix.md) — MCP server · ★ 29027
- [Repowise](https://affpapa.org/en/nevibecode/mcp/repowise.md) — MCP server · ★ 7891
- [sem](https://affpapa.org/en/nevibecode/mcp/sem.md) — MCP server · ★ 3422

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md