Quality MCP Server 🏍️

An MCP server that analyzes to your codebase, with plugin support for DCD and Simian. 🏍️ "The only Zen you find on the tops of mountains is the Zen you bring up there."

📚 Recommended Reading: Zen and the Art of Motorcycle Maintenance by Robert M. Pirsig - This project embodies the philosophy of quality as a way of being, not just a technical achievement. The book's exploration of "Quality" as an undefinable but recognizable concept aligns perfectly with our approach to code analysis and improvement.

🐛 Report Issues

Documentation

• Setup Guide
• Troubleshooting
• Development Guide
• Contributing

Quick Start

# Install globally
npm install -g quality-mcp

# Or install locally
npm install quality-mcp

# Setup DCD (recommended - open source)
# Global install:
quality-mcp setup-dcd
# Local install:
npm exec quality-mcp setup-dcd

# Test it works (from source checkout)
cd quality-mcp
npm test

Installation

From npm (Recommended)

npm install -g quality-mcp

From source

git clone https://bitbucket.org/grahampheath/quality-mcp.git
cd quality-mcp
npm install
#
# Run setup scripts from the repo root:
#   npm run setup-dcd
#   npm run setup

Usage

Add to your MCP client (like Cursor):

{
  "mcpServers": {
    "quality-mcp": {
      "command": "/path/to/node",
      "args": ["/path/to/quality-mcp/src/index.js"],
      "env": {
        "DCD_EXECUTABLE": "dcd"
      }
    }
  }
}

ChatGPT Codex MCP config (TOML)

Add to your Codex config (e.g., ~/.codex/config.toml):

[mcp_servers.quality-mcp]
command = "/path/to/node"
args = ["/path/to/quality-mcp/src/index.js"]
env = { DCD_EXECUTABLE = "dcd" }

Then use in your AI assistant:

"Find duplicate code in my src/ directory"

Tools Available

• analyze_duplicates_dcd - Find duplicates in files/directories
• scan_repository_dcd - Scan entire repository
• get_plugin_status - Check what's available

Setup Options

DCD (Recommended - Open Source)

go install github.com/boyter/dcd@latest

Simian (Commercial License Required)

Download from Simian website and set SIMIAN_EXECUTABLE env var.

Documentation

• Setup Guide - Detailed installation instructions
• Troubleshooting - Common issues and fixes

Development

npm test          # Run tests
npm run lint      # Check code style
npm run test:dcd  # Test DCD integration

Release

# Quick release
npm run release:patch  # Bug fixes
npm run release:minor  # New features
npm run release:major  # Breaking changes

# Commit messages
npm run commit         # Interactive
git commit -m "feat: add feature"  # Manual

License

MIT License - see LICENSE file.