# Hammer MCP

Hammer MCP is a standalone Model Context Protocol server for generating CAD
files. It exposes DXF and OpenSCAD operations to MCP clients. Check CLI version for CLI interactions

## Capabilities

- DXF drafting, saving, and PNG previews.
- OpenSCAD primitives, extrusion, Boolean operations, PNG rendering, and
  STL/3MF/OFF export.
- Local Ollama planning for multi-step natural-language requests.
- Guarded scripting with audit logging.

## Install and run

```powershell
python -m pip install -e ".[dev]"
hammer-cad-mcp
```

For an uninstalled checkout:

```powershell
$env:PYTHONPATH = "src"
python -m hammer_cad_mcp.server
```

The server uses MCP stdio transport and waits silently when started directly.

## MCP client configuration

```json
{
  "mcpServers": {
    "hammer-cad": {
      "command": "python",
      "args": ["-m", "hammer_cad_mcp.server"],
      "cwd": "C:\\path\\to\\HammerMCP",
      "env": {
        "PYTHONPATH": "C:\\path\\to\\HammerMCP\\src"
      }
    }
  }
}
```

Natural-language planning defaults to local `llama3:latest` through Ollama.
Change the model or URL in `config/config.json`.

## Test

```powershell
python -m pytest -q
python scripts\mcp_smoke_test.py
```

Generated files are written to `output/`.