# mcp-server-analyzer

This MCP server checks Python, JavaScript, and TypeScript with Ruff, ty, Vulture, and Biome. Use it for code review, formatting, and dead-code checks.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11
- Author: Anselmoo
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Anselmoo/mcp-server-analyzer
- Updated: 2026-08-30
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-server-analyzer

## What it does

mcp-server-analyzer gives an AI coding client tools for source analysis. Python checks cover Ruff linting, ty type diagnostics, and Vulture scans for unused imports, functions, and variables. Biome handles linting and formatting for JavaScript and TypeScript.

The server exposes focused tools such as `ruff-check`, `ruff-format`, `ruff-check-ci`, `ty-check`, `vulture-scan`, `biome-check`, and `biome-format`. `analyze-code` combines Ruff, ty, and Vulture into one assessment and can return quality metrics.

Python 3.13+ and `uv` or `pip` are required to run it. In Claude Code, the server is registered with `claude mcp add`, then the agent can call these analysis tools from the project.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server-analyzer -- uvx mcp-server-analyzer
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-analyzer <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server-analyzer -- uvx mcp-server-analyzer
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-analyzer <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-analyzer": {
            "command": "uvx",
            "args": [
                "mcp-server-analyzer"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-analyzer <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-analyzer": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-server-analyzer"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-analyzer <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add mcp-server-analyzer uvx mcp-server-analyzer
```
uvx runs the command named after the package; if the README names another one, use uvx --from mcp-server-analyzer <command>

## When to use it
- lint Python files with Ruff
- check Python types and return values
- find unused imports, functions, and variables
- format JavaScript and TypeScript with Biome
- run a combined code-quality assessment

## Example prompts
- Run Ruff checks on this Python project and explain the findings.
- Use `ty-check` to inspect the type errors in these files.
- Scan the project for dead code, then run Biome checks on the JavaScript files.

## Similar
- [ultracite](https://affpapa.org/en/nevibecode/skills/ultracite.md) — skill · 11400 installs
- [typescript-quality](https://affpapa.org/en/nevibecode/skills/typescript-quality.md) — skill · 1100 installs
- [tech-debt-analyzer](https://affpapa.org/en/nevibecode/skills/tech-debt-analyzer.md) — skill · 985 installs
- [lint-and-validate](https://affpapa.org/en/nevibecode/skills/sickn33-lint-and-validate.md) — skill · 1300 installs
- [vulture-dead-code](https://affpapa.org/en/nevibecode/skills/vulture-dead-code.md) — skill · 317 installs
- [biome](https://affpapa.org/en/nevibecode/skills/biome.md) — skill · 927 installs

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