加泰罗尼亚语文本校正器

# Install and setup
uv sync && uv pip install -e .
docker compose up -d

# Run the MCP server
uv run python -m corrector.server

# Run tests
uv run pytest tests/ -v

Claude (Code CLI or claude.ai)
  → MCP Server (src/corrector/server.py, Python + FastMCP)
    → LanguageTool Docker (localhost:8011)

# Clone the repository
git clone <repository-url>
cd mcp-corrector-dual-cat-en

# Install dependencies
uv sync

# Start LanguageTool Docker
docker compose up -d

# Verify LanguageTool is running
curl http://localhost:8011/v2/languages | head

claude mcp add corrector-catala -- uv run python -m corrector.server

corregir_text_mixt(
    text: str,           # Text to correct (prose, Markdown, or full files)
    variant: str = "general",  # "general", "valencia", or "balear"
    picky: bool = False,       # Enable strict style rules
    debug: bool = False,       # Include debug info in response
    format_json: bool = True   # Return JSON or plain text
)

El `callback` es crida quan el *promis* es resol.

```javascript
// Això carrega les dades
fetch(url).then(data => {
    console.log(data);  // Log the respons
});

**Detected errors:**
- `promis` → `promise` (English term, checked with en-US)
- `Això` in comment → checked with ca-ES
- `respons` → `response` (English comment typo)

#### `corregir_text`

Simple monolingual Catalan correction (no code handling).

#### `verificar_servidor`

Check if LanguageTool Docker is running.

#### `llistar_idiomes`

List available languages on the LanguageTool server.

### Running the Server

```bash
# stdio transport (for Claude Code CLI)
uv run python -m corrector.server

# HTTP transport (for claude.ai via ngrok)
uv run python -m corrector.server --transport streamable-http --port 8000

# Run all tests (requires LanguageTool Docker running)
uv run pytest tests/ -v

# Run specific phase tests
uv run pytest tests/test_phase1.py -v
uv run pytest tests/test_phase2.py -v
uv run pytest tests/test_phase3.py -v

├── src/
│   └── corrector/
│       ├── __init__.py           # Package exports
│       ├── server.py             # MCP server and tool definitions
│       ├── preprocessor.py       # Phase 1: code detection and blanking
│       ├── text_spans.py         # Span utilities (merge, blank, filter)
│       ├── english_detector.py   # Phase 2: English dictionary and fuzzy matching
│       ├── match_filter.py       # Phase 2: match partitioning and remapping
│       ├── comment_extractor.py  # Phase 3: string-aware comment parser
│       └── comment_checker.py    # Phase 3: comment batching and routing
├── data/
│   └── terms_en.txt              # English technical terms dictionary
├── tests/
│   ├── conftest.py               # pytest configuration
│   ├── test_phase1.py            # Blanking tests
│   ├── test_phase2.py            # English term routing tests
│   ├── test_phase3.py            # Comment extraction tests
│   └── test_document_phases.py   # Integration tests
├── docs/
│   ├── CLAUDE.md                 # Project instructions
│   └── plans/                    # Implementation design documents
├── pyproject.toml
├── docker-compose.yml            # LanguageTool Docker config
└── README.md