codehealth-mcplisted
Install: claude install-skill Mixard/fable-pack
# Code Health MCP (CodeScene)
Structural (design-level) maintainability scoring for files and change sets, complementing lint/style checks. Upstream: codescene-oss/codescene-mcp-server; package `@codescene/codehealth-mcp` (stdio via npx).
## Setup
Claude Code (`~/.claude.json` -> `mcpServers`), or the same block in a repo-root `.mcp.json` for project scope:
```json
"codescene": {
"command": "npx",
"args": ["-y", "@codescene/codehealth-mcp"],
"env": {
"CS_ACCESS_TOKEN": "YOUR_CS_ACCESS_TOKEN_HERE"
}
}
```
`CS_ACCESS_TOKEN` is a personal access token (see the upstream repo's `docs/getting-a-personal-access-token.md`). Standalone mode does not require a paid CodeScene platform account for the four tools below. Restart the session and confirm the server is connected before relying on scores.
## Standalone tools (the only ones to call)
| Tool | When to use |
|------|-------------|
| `code_health_review` | Full structural analysis before modifying a file (baseline score + listed code smells) |
| `code_health_score` | Quick numeric score after each change (delta check) |
| `pre_commit_code_health_safeguard` | Block commits that introduce Code Health regressions |
| `analyze_change_set` | Branch-level check before opening a PR |
Do not call platform-only tools (e.g. repository-wide hotspot lists), and do not reference `delta_analysis` - it is not available on standalone.
## Score interpretation (1-10)
| Range | Meaning | Behavior |
|-------|---------|----------|