crucible-mcp 0.1.0__tar.gz

crucible_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: crucible-mcp
+Version: 0.1.0
+Summary: Code review MCP server for Claude. Not affiliated with Atlassian.
+Author: be.nvy
+License-Expression: MIT
+Keywords: mcp,code-review,static-analysis,claude
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
+Requires-Dist: ruff>=0.3; extra == "dev"
+
+# Crucible
+
+Code review MCP server for Claude. Runs static analysis and loads review skills based on what kind of code you're looking at.
+
+> **Note:** This project is not affiliated with Atlassian or their Crucible code review tool. Just an unfortunate naming collision.
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  Your Code  ──→  Crucible  ──→  Claude                                       │
+│                  (analysis)     (synthesis)                                  │
+│                                                                             │
+│  .sol file  ──→  slither, semgrep  ──→  web3-engineer skill loaded          │
+│  .py file   ──→  ruff, bandit      ──→  backend-engineer skill loaded       │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+**MCP provides data. Skills provide perspective. Claude orchestrates.**
+
+## Quick Start
+
+```bash
+# Install from PyPI
+pip install crucible-mcp
+
+# Or install from source
+pip install -e ".[dev]"
+
+# Install skills to ~/.claude/crucible/skills/
+crucible skills install
+
+# Install analysis tools for your stack
+pip install semgrep ruff              # Python
+pip install slither-analyzer          # Solidity
+pip install bandit                    # Python security
+```
+
+> **Tools are separate by design.** Different workflows need different analyzers. Install what you need, skip what you don't. Crucible gracefully handles missing tools.
+
+## MCP Setup
+
+Works with any MCP client (Claude Code, Cursor, etc.). Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "crucible-mcp"
+    }
+  }
+}
+```
+
+Then in Claude:
+
+```
+Review src/Vault.sol
+
+→ Crucible: domains_detected: [solidity, smart_contract, web3]
+→ Crucible: severity_summary: {critical: 1, high: 3}
+→ Claude loads: web3-engineer, security-engineer skills
+→ Claude synthesizes multi-perspective review
+```
+
+## 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
+
+```bash
+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
+```
+
+## How It Works
+
+Crucible detects what kind of code you're reviewing, runs the right analysis tools, and returns findings with domain metadata. Claude uses this to load appropriate review skills.
+
+```
+.sol file  →  slither + semgrep  →  web3-engineer, gas-optimizer skills
+.py file   →  ruff + bandit      →  backend-engineer, security-engineer skills
+```
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full flow.
+
+## Customization
+
+Override skills and knowledge for your project or personal preferences:
+
+```bash
+# 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](docs/CUSTOMIZATION.md) for the full guide.
+
+## What's Included
+
+**18 Review Skills** — Different review perspectives (security, performance, accessibility, web3, etc.)
+
+See [SKILLS.md](docs/SKILLS.md) for the full list with triggers and focus areas.
+
+**12 Knowledge Files** — Engineering principles for security, testing, APIs, databases, smart contracts, etc.
+
+See [KNOWLEDGE.md](docs/KNOWLEDGE.md) for topics covered and skill linkages.
+
+## Documentation
+
+| Doc | What's In It |
+|-----|--------------|
+| [FEATURES.md](docs/FEATURES.md) | Complete feature reference |
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | How MCP, tools, skills, and knowledge fit together |
+| [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) | Override skills and knowledge for your project |
+| [SKILLS.md](docs/SKILLS.md) | All 18 review personas with triggers and key questions |
+| [KNOWLEDGE.md](docs/KNOWLEDGE.md) | All 12 knowledge files with topics covered |
+| [CONTRIBUTING.md](docs/CONTRIBUTING.md) | Adding tools, skills, and knowledge |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # Run tests (263 tests)
+ruff check src/ --fix     # Lint
+```

crucible_mcp-0.1.0/README.md

@@ -0,0 +1,141 @@
+# Crucible
+
+Code review MCP server for Claude. Runs static analysis and loads review skills based on what kind of code you're looking at.
+
+> **Note:** This project is not affiliated with Atlassian or their Crucible code review tool. Just an unfortunate naming collision.
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  Your Code  ──→  Crucible  ──→  Claude                                       │
+│                  (analysis)     (synthesis)                                  │
+│                                                                             │
+│  .sol file  ──→  slither, semgrep  ──→  web3-engineer skill loaded          │
+│  .py file   ──→  ruff, bandit      ──→  backend-engineer skill loaded       │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+**MCP provides data. Skills provide perspective. Claude orchestrates.**
+
+## Quick Start
+
+```bash
+# Install from PyPI
+pip install crucible-mcp
+
+# Or install from source
+pip install -e ".[dev]"
+
+# Install skills to ~/.claude/crucible/skills/
+crucible skills install
+
+# Install analysis tools for your stack
+pip install semgrep ruff              # Python
+pip install slither-analyzer          # Solidity
+pip install bandit                    # Python security
+```
+
+> **Tools are separate by design.** Different workflows need different analyzers. Install what you need, skip what you don't. Crucible gracefully handles missing tools.
+
+## MCP Setup
+
+Works with any MCP client (Claude Code, Cursor, etc.). Add to your `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "crucible": {
+      "command": "crucible-mcp"
+    }
+  }
+}
+```
+
+Then in Claude:
+
+```
+Review src/Vault.sol
+
+→ Crucible: domains_detected: [solidity, smart_contract, web3]
+→ Crucible: severity_summary: {critical: 1, high: 3}
+→ Claude loads: web3-engineer, security-engineer skills
+→ Claude synthesizes multi-perspective review
+```
+
+## 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
+
+```bash
+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
+```
+
+## How It Works
+
+Crucible detects what kind of code you're reviewing, runs the right analysis tools, and returns findings with domain metadata. Claude uses this to load appropriate review skills.
+
+```
+.sol file  →  slither + semgrep  →  web3-engineer, gas-optimizer skills
+.py file   →  ruff + bandit      →  backend-engineer, security-engineer skills
+```
+
+See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full flow.
+
+## Customization
+
+Override skills and knowledge for your project or personal preferences:
+
+```bash
+# 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](docs/CUSTOMIZATION.md) for the full guide.
+
+## What's Included
+
+**18 Review Skills** — Different review perspectives (security, performance, accessibility, web3, etc.)
+
+See [SKILLS.md](docs/SKILLS.md) for the full list with triggers and focus areas.
+
+**12 Knowledge Files** — Engineering principles for security, testing, APIs, databases, smart contracts, etc.
+
+See [KNOWLEDGE.md](docs/KNOWLEDGE.md) for topics covered and skill linkages.
+
+## Documentation
+
+| Doc | What's In It |
+|-----|--------------|
+| [FEATURES.md](docs/FEATURES.md) | Complete feature reference |
+| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | How MCP, tools, skills, and knowledge fit together |
+| [CUSTOMIZATION.md](docs/CUSTOMIZATION.md) | Override skills and knowledge for your project |
+| [SKILLS.md](docs/SKILLS.md) | All 18 review personas with triggers and key questions |
+| [KNOWLEDGE.md](docs/KNOWLEDGE.md) | All 12 knowledge files with topics covered |
+| [CONTRIBUTING.md](docs/CONTRIBUTING.md) | Adding tools, skills, and knowledge |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                    # Run tests (263 tests)
+ruff check src/ --fix     # Lint
+```

crucible_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "crucible-mcp"
+version = "0.1.0"
+description = "Code review MCP server for Claude. Not affiliated with Atlassian."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{ name = "be.nvy" }]
+keywords = ["mcp", "code-review", "static-analysis", "claude"]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "pyyaml>=6.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "mypy>=1.8",
+    "ruff>=0.3",
+]
+
+[project.scripts]
+crucible = "crucible.cli:main"
+crucible-mcp = "crucible.server:main"
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP", "B", "C4", "SIM"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_ignores = true
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

crucible_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

crucible_mcp-0.1.0/src/crucible/__init__.py

@@ -0,0 +1,3 @@
+"""crucible: Code review orchestration MCP server."""
+
+__version__ = "0.1.0"