quality-mcp/setup.md

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

# Setup Guide

## DCD (Recommended - Open Source)

DCD is the recommended tool - it's free, fast, and open source.

### Install DCD

```bash
# Install Go if you don't have it
# Download from: https://golang.org/dl/

# Install DCD
go install github.com/boyter/dcd@latest

# Add to PATH (Linux/macOS)
export PATH=$PATH:$(go env GOPATH)/bin

# Test installation
dcd --version
```

### Configure MCP Client

Add to your MCP configuration (e.g., Cursor's `mcp-servers.json`):

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

## Simian (Commercial License Required)

If you have a Simian license:

1. Download from [Simian website](https://www.harukizaemon.com/simian/)
2. Set the `SIMIAN_EXECUTABLE` environment variable to point to the JAR file
3. Add to your MCP configuration:

```json
{
  "mcpServers": {
    "quality-mcp": {
      "command": "/path/to/node",
      "args": ["/path/to/quality-mcp/src/index.js"],
      "env": {
        "SIMIAN_EXECUTABLE": "/path/to/simian.jar"
      }
    }
  }
}
```

## Test Installation

```bash
# Test DCD integration
npm run test:dcd

# Run all tests
npm test
```

## Troubleshooting

- **"DCD not found"**: Make sure DCD is in your PATH
- **"Simian failed"**: Check the JAR file path and license
- **"0 tools enabled"**: Restart your MCP client after configuration changes

See [troubleshooting.md](troubleshooting.md) for more help.