crucible-mcp 0.2.0

Code review MCP server for Claude. Not affiliated with Atlassian.

Crucible

Load your coding patterns into Claude Code.

├── Personas:      Domain-specific thinking (how to approach problems)
├── Knowledge:     Coding patterns and principles (what to apply)
├── Cascade:       Project → User → Bundled (customizable at every level)
└── Context-aware: Loads relevant skills based on what you're working on

Personas for domains. Knowledge for patterns. All customizable.

Not affiliated with Atlassian's Crucible.

Install

pip install crucible-mcp

Add to Claude Code (.mcp.json):

{
  "mcpServers": {
    "crucible": {
      "command": "crucible-mcp"
    }
  }
}

With hot reload (recommended for customization):

{
  "mcpServers": {
    "crucible": {
      "command": "mcpmon",
      "args": ["--watch", "~/.crucible/", "--", "crucible-mcp"]
    }
  }
}

How It Works

Code → Detect Domain → Load Personas + Knowledge → Claude with YOUR patterns

.sol file → web3 domain → security-engineer + SMART_CONTRACT.md → Knows your security rules

MCP Tools

Tool	Purpose
quick_review(path)	Run analysis, return findings + domains
get_principles(topic)	Load engineering knowledge
delegate_*	Direct tool access (semgrep, ruff, slither, bandit)
check_tools()	Show installed analysis tools

CLI

crucible skills list              # List all skills
crucible skills show <skill>      # Show which version is active
crucible skills init <skill>      # Copy to .crucible/ for customization

crucible knowledge list           # List all knowledge files
crucible knowledge init <file>    # Copy for customization

See ARCHITECTURE.md for the full flow.

Customization

Override skills and knowledge for your project or personal preferences:

# Customize a skill for your project
crucible skills init security-engineer
# Creates .crucible/skills/security-engineer/SKILL.md

# Add project-specific concerns, team conventions, etc.

Resolution order (first found wins):

1. .crucible/ — Project overrides
2. ~/.claude/crucible/ — User preferences
3. Bundled — Package defaults

See CUSTOMIZATION.md for the full guide.

What's Included

18 Personas — Domain-specific thinking: security, performance, accessibility, web3, backend, and more.

See SKILLS.md for the full list.

12 Knowledge Files — Coding patterns and principles for security, testing, APIs, databases, smart contracts, etc.

See KNOWLEDGE.md for topics covered.

Documentation

Doc	What's In It
FEATURES.md	Complete feature reference
ARCHITECTURE.md	How MCP, tools, skills, and knowledge fit together
CUSTOMIZATION.md	Override skills and knowledge for your project
SKILLS.md	All 18 personas with triggers and focus areas
KNOWLEDGE.md	All 12 knowledge files with topics covered
CONTRIBUTING.md	Adding tools, skills, and knowledge

Development

pip install -e ".[dev]"
pytest                    # Run tests (494 tests)
ruff check src/ --fix     # Lint