What is mete?

mete analyzes your codebase and reports structural quality metrics:

• Maintainability Index (MI) - Overall code health score (0-100)
• Cyclomatic Complexity (CC) - Number of independent paths through code
• Cognitive Complexity - How hard code is to understand
• Nesting Depth - Maximum control structure depth
• Code Duplication - Repeated code blocks across files
• Structural Entropy - Complexity distribution via Shannon entropy

Supports: Rust, TypeScript, JavaScript, Python, Go, Java, C#, C++, Elixir

Install as MCP Server

mete works as an MCP (Model Context Protocol) server, giving AI assistants direct access to code quality analysis.

Claude Code

claude mcp add mete -- mete mcp

Cursor

Or manually add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mete": {
      "command": "mete",
      "args": ["mcp"]
    }
  }
}

VS Code

Add to your VS Code MCP settings:

{
  "mcp": {
    "servers": {
      "mete": {
        "command": "mete",
        "args": ["mcp"]
      }
    }
  }
}

OpenCode

Add to ~/.config/opencode/config.json:

{
  "mcp": {
    "mete": {
      "command": "mete",
      "args": ["mcp"]
    }
  }
}

MCP Tools Available

| Tool | Description | |------|-------------| | analyze | File/directory quality metrics (MI, CC, cognitive complexity, depth) | | targets | AI-friendly refactoring suggestions sorted by priority | | functions | Function-level metrics with filtering by complexity/size/depth | | duplicates | Detect duplicate code blocks (exact and cross-file similar) | | entropy | Measure structural complexity distribution |

Installation

From crates.io (Rust)

cargo install mete --features mcp

From npm (Node.js)

npm install -g @dutch.casa/mete-rs

From source

git clone https://github.com/dutch-casa/mete.rs
cd mete.rs
cargo install --path . --features mcp

CLI Usage

Analyze a file or directory

mete analyze src/
mete analyze src/main.rs

Find refactoring targets (AI-friendly)

mete targets src/ --limit 10

Function-level metrics

mete functions src/ --complex    # Show only complex functions
mete functions src/ --large      # Show only large functions (>50 LOC)
mete functions src/ --deep       # Show only deeply nested functions

Find duplicate code

mete duplicates src/
mete duplicates src/ --cross-file --threshold 0.8

Measure structural entropy

mete entropy src/

Explain metrics

mete explain mi
mete explain cc
mete explain depth

Metrics

Maintainability Index (MI)

Measures code maintainability on a scale of 0-100. Higher is better.

| Range | Rating | |-------|--------| | 85-100 | Excellent | | 65-84 | Good | | 50-64 | Moderate | | 0-49 | Poor |

Cyclomatic Complexity (CC)

Number of linearly independent paths through code. Lower is better.

| Range | Rating | |-------|--------| | 1-5 | Simple | | 6-10 | Moderate | | 11-20 | Complex | | 21+ | Very Complex |

Nesting Depth

Maximum depth of nested control structures. Lower is better.

| Range | Rating | |-------|--------| | 1-2 | Flat | | 3-4 | Moderate | | 5-6 | Deep | | 7+ | Very Deep |

Star History

License

MIT