btx_fix_mcp

Code review and automated fixing tools - available as CLI and MCP server.

What is btx_fix_mcp?

btx_fix_mcp provides comprehensive code analysis:

• 18+ Quality Analyses: Complexity, maintainability, duplication, type coverage, dead code
• Security Scanning: Bandit integration for vulnerability detection
• Cache Optimization: Evidence-based @lru_cache recommendations
• Documentation Coverage: Docstring completeness analysis

Two ways to use it:

Mode	Best For
CLI	Direct command-line usage, CI/CD pipelines, scripts
MCP Server	Integration with Claude Desktop, AI-assisted workflows

---

Quick Start

Installation

# Recommended: uv
pip install uv
uv pip install btx_fix_mcp

# Alternative: pip
pip install btx_fix_mcp

# Development
git clone https://github.com/bitranox/btx_fix_mcp
cd btx_fix_mcp && make dev

CLI Usage (Simple)

# Deploy configuration (recommended first step) - this creates a config file with the settings for all tests to adjust
btx_fix_mcp config-deploy --target app

# Review uncommitted git changes (default)
btx_fix_mcp review all

# Review all files
btx_fix_mcp review all --mode full

# Run specific analysis
btx_fix_mcp review quality
btx_fix_mcp review security

# Cache optimization with profiling (recommended)
btx_fix_mcp review profile -- python -m your_app    # Profile your app
btx_fix_mcp review profile -- pytest tests/         # Or profile tests
btx_fix_mcp review cache                            # Then analyze

# Clean up analysis data
btx_fix_mcp review clean                            # Delete all
btx_fix_mcp review clean -s profile                 # Delete profile only
btx_fix_mcp review clean --dry-run                  # Preview deletion

MCP Server Usage (Simple)

Add to Claude Desktop config (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "btx-review": {
      "command": "python",
      "args": ["-m", "btx_fix_mcp.servers.review"]
    }
  }
}

Then in Claude Desktop:

"Review the code quality of this project"

---

Documentation

Getting Started

Document	Description
CLI Quickstart	Start using CLI in 5 minutes
MCP Quickstart	Set up MCP server for Claude Desktop
Installation Guide	All installation methods

User Guides

Document	Description
CLI Reference	All CLI commands and options
MCP Tools Reference	MCP tools and resources
Configuration	All configuration options
Cache Profiling	LRU cache optimization guide

Development

Document	Description
Development Guide	Setup, testing, make targets
Architecture	System design overview
Contributing	How to contribute

---

Features Overview

Analyses Available

Analysis	Description	CLI Command
Scope	File discovery, git changes	review scope
Quality	Complexity, maintainability, duplication	review quality
Security	Vulnerability scanning (Bandit)	review security
Dependencies	Outdated packages, vulnerabilities	review deps
Documentation	Docstring coverage	review docs
Performance	Hotspot detection, profiling	review perf
Cache	LRU cache optimization	review cache

Quality Metrics

Metric	Tool	Threshold
Cyclomatic Complexity	radon	≤10
Function Length	custom	≤50 lines
Nesting Depth	custom	≤3 levels
Maintainability Index	radon	≥20
Type Coverage	mypy	≥80%
Docstring Coverage	interrogate	≥80%

---

Requirements

• Python 3.13+
• Git (optional)

Git Integration

Git is optional but enables additional features:

Feature	Without Git	With Git
Scope Mode	--mode full scans all files	--mode git scans only uncommitted changes (default)
Code Churn	Skipped	Analyzes frequently modified files
Branch Info	Shows "N/A"	Displays current branch

When git is not available:

• --mode git automatically falls back to --mode full with a warning
• Code churn analysis is skipped silently
• Cache analysis works without git (uses in-memory file backup)
• All other analyses work normally

---

License

MIT License

---

Links

• PyPI
• GitHub
• Issues
• Changelog