local-delegate-mcp 0.1.0__tar.gz

local_delegate_mcp-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,21 @@
+---
+name: Reporte de bug
+about: Algo no funciona como debería
+title: "[bug] "
+labels: bug
+---
+
+**Descripción**
+Qué pasa vs. qué esperabas.
+
+**Reproducir**
+Pasos para reproducir el problema.
+
+**Entorno**
+- SO:
+- Versión de `local-delegate-mcp`:
+- Backend OpenAI-compatible (llama-swap / Ollama / LM Studio / vLLM) y versión:
+- `LOCAL_DELEGATE_BASE_URL`:
+
+**Logs**
+Salida relevante (sin secretos).

local_delegate_mcp-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Propuesta de mejora
+about: Sugiere una idea o una nueva capacidad
+title: "[feat] "
+labels: enhancement
+---
+
+**Problema**
+Qué necesidad o fricción motiva la propuesta.
+
+**Propuesta**
+Qué te gustaría que hiciera.
+
+**Alternativas**
+Otras opciones que consideraste.
+
+**Contexto**
+¿Encaja con el objetivo de mantener el paquete genérico (cualquier endpoint OpenAI-compatible)?

local_delegate_mcp-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## Descripción
+
+<!-- Qué cambia y por qué. -->
+
+## Checklist
+
+- [ ] `uv run ruff check .` pasa
+- [ ] `uv run ruff format --check .` pasa
+- [ ] `uv run pytest` pasa
+- [ ] Actualicé `CHANGELOG.md` (sección *Unreleased*) si aplica
+- [ ] No incluyo secretos ni configs reales (solo `*.example`)
+- [ ] El cambio mantiene el paquete **genérico** (nada específico de un backend/máquina en el código)

local_delegate_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.11"
+
+      - name: Sync deps
+        run: uv sync --group dev
+
+      - name: Lint (ruff)
+        run: uv run ruff check .
+
+      - name: Format check (ruff)
+        run: uv run ruff format --check .
+
+      - name: Tests (pytest)
+        run: uv run pytest -q
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Validate dashboard JS
+        run: |
+          uv run python scripts/extract_dashboard_js.py dashboard.js
+          node --check dashboard.js
+
+  secrets:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Scan for secrets (gitleaks)
+        uses: gitleaks/gitleaks-action@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

local_delegate_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,30 @@
+name: Publish
+
+# Publica en PyPI al empujar un tag vX.Y.Z, usando Trusted Publishing (OIDC):
+# sin tokens guardados en secrets. Requiere configurar un "trusted publisher" en PyPI
+# para el proyecto local-delegate-mcp (owner ZahiriNatZuke, repo local-delegate,
+# workflow publish.yml, environment pypi).
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # necesario para OIDC / Trusted Publishing
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.11"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI (trusted publishing)
+        run: uv publish --trusted-publishing always

local_delegate_mcp-0.1.0/.gitignore

@@ -0,0 +1,27 @@
+# Datos de uso (NUNCA versionar): el log de delegaciones
+usage.jsonl
+*.jsonl
+
+# Python
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info/
+
+# Entornos virtuales
+.venv/
+.env
+
+# Artefactos de demo / scratch
+_demo*
+scratch_*
+scratch/
+
+# Config local de Claude Code (lleva rutas absolutas / puede tener secretos)
+.claude/
+
+# Secretos y credenciales (por si acaso; solo se versionan *.example)
+*.secret
+secrets.*

local_delegate_mcp-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+# pre-commit: bloquea secretos y aplica lint/formato antes de cada commit.
+# Instala con:  uv run pre-commit install
+repos:
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.18.4
+    hooks:
+      - id: gitleaks
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format

local_delegate_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

local_delegate_mcp-0.1.0/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+Todos los cambios notables de este proyecto se documentan aquí.
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/)
+y el proyecto usa [Versionado Semántico](https://semver.org/lang/es/).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-07-07
+
+### Added
+- Servidor MCP stdio con 9 tools texto→texto (`local_summarize`, `local_classify`,
+  `local_extract`, `local_boilerplate`, `local_delegate`, `local_lint_summary`,
+  `local_commit_msg`, `local_translate`, `local_explain_code`).
+- Cliente genérico de cualquier endpoint OpenAI-compatible (llama-swap, Ollama, LM Studio, vLLM),
+  configurable por variables de entorno; sin rutas hardcodeadas (`platformdirs` para el log).
+- Web de métricas embebida (dashboard de uso/ahorro) en un hilo daemon.
+- Logging JSONL por llamada (`usage.jsonl`) para calcular el ahorro de contexto.
+- Auto-arranque de llama-swap opcional (opt-in, `LOCAL_DELEGATE_AUTOSTART=0` por defecto).
+- Empaquetado para PyPI (`local-delegate-mcp`) ejecutable con `uvx`; `server.json` para el
+  registro oficial de MCP.
+
+[Unreleased]: https://github.com/ZahiriNatZuke/local-delegate/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/ZahiriNatZuke/local-delegate/releases/tag/v0.1.0

local_delegate_mcp-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,33 @@
+# Código de conducta — Contributor Covenant
+
+## Nuestro compromiso
+
+Con el interés de fomentar una comunidad abierta y acogedora, quienes contribuimos y mantenemos
+este proyecto nos comprometemos a hacer de la participación una experiencia libre de acoso para
+todas las personas, sin importar edad, tamaño corporal, discapacidad, etnia, identidad y expresión
+de género, nivel de experiencia, nacionalidad, apariencia, raza, religión, u orientación e
+identidad sexual.
+
+## Nuestros estándares
+
+Ejemplos de comportamiento que contribuyen a un ambiente positivo:
+
+- Usar lenguaje acogedor e inclusivo.
+- Respetar puntos de vista y experiencias diferentes.
+- Aceptar con gracia la crítica constructiva.
+- Centrarse en lo que es mejor para la comunidad.
+
+Ejemplos de comportamiento inaceptable:
+
+- Lenguaje o imágenes sexualizadas y atención sexual no deseada.
+- Comentarios insultantes o despectivos, y ataques personales o políticos (*trolling*).
+- Acoso público o privado.
+- Publicar información privada de terceros sin permiso.
+
+## Aplicación
+
+Los casos de comportamiento abusivo, acosador o inaceptable pueden reportarse abriendo un issue o
+contactando a quien mantiene el proyecto. Todas las quejas se revisarán e investigarán.
+
+Este código de conducta es una adaptación del [Contributor Covenant](https://www.contributor-covenant.org),
+versión 2.1.

local_delegate_mcp-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,45 @@
+# Contribuir a local-delegate
+
+¡Gracias por tu interés! Este proyecto es un MCP stdio en Python gestionado con [`uv`](https://docs.astral.sh/uv/).
+
+## Entorno de desarrollo
+
+```bash
+uv sync --group dev        # crea .venv e instala deps + dev tools
+uv run pytest              # tests
+uv run ruff check .        # lint
+uv run ruff format .       # formato
+```
+
+Python **≥ 3.11**. Usa siempre `uv` (no el `python` del sistema).
+
+## Ejecutar el MCP localmente
+
+```bash
+uv run local-delegate      # arranca el server stdio (necesita un endpoint OpenAI-compatible)
+```
+
+La web de métricas queda en `http://127.0.0.1:9393` (desactiva con `LOCAL_DELEGATE_WEB=0`).
+
+## Reglas del proyecto
+
+- **Cliente genérico:** el paquete solo asume "un endpoint OpenAI-compatible en una URL". Nada
+  específico de un backend, hardware o máquina debe entrar al código: va a `docs/recipes/`.
+- **Sin rutas hardcodeadas:** todo configurable por variables de entorno (ver README).
+- **Nunca subas secretos** ni tus configs reales de Claude. Solo plantillas `*.example`.
+  `gitleaks` corre en pre-commit y CI.
+
+## Pull requests
+
+1. Crea una rama desde `main`.
+2. Asegúrate de que `ruff check`, `ruff format --check` y `pytest` pasan.
+3. Actualiza `CHANGELOG.md` (sección *Unreleased*).
+4. Describe el cambio con claridad en el PR.
+
+## pre-commit
+
+```bash
+uv run pre-commit install    # (o pipx run pre-commit install)
+```
+
+Corre `gitleaks` antes de cada commit para bloquear secretos.

local_delegate_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yohan González Almaguer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

local_delegate_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: local-delegate-mcp
+Version: 0.1.0
+Summary: Delegate mechanical text tasks to a local OpenAI-compatible LLM endpoint to conserve Claude subscription quota.
+Project-URL: Homepage, https://github.com/ZahiriNatZuke/local-delegate
+Project-URL: Repository, https://github.com/ZahiriNatZuke/local-delegate
+Project-URL: Issues, https://github.com/ZahiriNatZuke/local-delegate/issues
+Author: Yohan González Almaguer
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude,llama-swap,llm,local,mcp,ollama,openai-compatible,quota
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2
+Requires-Dist: platformdirs>=4
+Requires-Dist: uvicorn>=0.30
+Description-Content-Type: text/markdown
+
+<!-- mcp-name: io.github.ZahiriNatZuke/local-delegate -->
+
+# local-delegate
+
+**Delega tareas mecánicas texto→texto a un LLM local para conservar la cuota de tu suscripción de Claude.**
+Un servidor MCP (stdio) que es cliente **genérico** de cualquier endpoint OpenAI-compatible —
+llama-swap, Ollama, LM Studio, vLLM.
+
+[![PyPI](https://img.shields.io/pypi/v/local-delegate-mcp.svg)](https://pypi.org/project/local-delegate-mcp/)
+[![CI](https://github.com/ZahiriNatZuke/local-delegate/actions/workflows/ci.yml/badge.svg)](https://github.com/ZahiriNatZuke/local-delegate/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+## ¿Por qué?
+
+Cuando Claude tiene que resumir un log enorme, clasificar, extraer campos o generar boilerplate,
+gasta cuota de tu suscripción en trabajo **mecánico**. `local-delegate` expone esas tareas como
+tools MCP que corren en un LLM **local**: pasas `path` en vez de `text` y el archivo se lee
+**del lado del servidor**, así el contenido grande **nunca entra al contexto de Claude**. Solo
+vuelve el resultado corto — cuota que no gastaste.
+
+## Instalación rápida
+
+Con [`uv`](https://docs.astral.sh/uv/) no hay nada que instalar: `uvx` baja y ejecuta el paquete aislado.
+
+Añádelo a tu config de MCP (Claude Desktop / Claude Code):
+
+```json
+{
+  "mcpServers": {
+    "local-delegate": {
+      "command": "uvx",
+      "args": ["local-delegate-mcp"]
+    }
+  }
+}
+```
+
+Ver plantillas completas en [`examples/`](./examples).
+
+## Requisitos
+
+Un **endpoint OpenAI-compatible** ya corriendo, accesible en `LOCAL_DELEGATE_BASE_URL`
+(default `http://127.0.0.1:9292/v1`). Cualquiera sirve:
+
+- **llama-swap** — ver [recipe con GPU Blackwell](./docs/recipes/) *(en construcción)*.
+- **Ollama** — `http://127.0.0.1:11434/v1`.
+- **LM Studio**, **vLLM**, o cualquier servidor que hable la API de OpenAI.
+
+El paquete **no arranca** ningún backend por defecto (`LOCAL_DELEGATE_AUTOSTART=0`). El
+auto-arranque de llama-swap es opt-in (ver tabla de configuración).
+
+## Tools
+
+Pasar `path` (en vez de `text`) hace que el MCP lea el archivo server-side → ahorro real de cuota.
+
+| Tool | Qué hace | Rol de modelo (default) |
+|---|---|---|
+| `local_summarize` | Resume texto o archivo | mecánico / largo (auto) |
+| `local_classify` | Devuelve UNA etiqueta de una lista | mecánico |
+| `local_extract` | Extrae campos → objeto JSON | mecánico |
+| `local_boilerplate` | Genera código desde una spec | código |
+| `local_delegate` | Escape genérico texto→texto | mecánico (o el que pases) |
+| `local_lint_summary` | Resume logs de lint/tests/CI | mecánico / largo (auto) |
+| `local_commit_msg` | Mensaje de commit desde un diff | código |
+| `local_translate` | Traduce texto o archivo | mecánico / largo (auto) |
+| `local_explain_code` | Explica código en prosa | código |
+
+Los modelos locales **no** usan tool-calling: el server arma el prompt + guardrails, hace POST al
+endpoint y devuelve **solo texto**.
+
+## Configuración
+
+Todo por variables de entorno; nada hardcodeado. Los ids de modelo default son solo eso —
+cámbialos por los de tu backend.
+
+| Variable | Default | Descripción |
+|---|---|---|
+| `LOCAL_DELEGATE_BASE_URL` | `http://127.0.0.1:9292/v1` | Endpoint OpenAI-compatible |
+| `LOCAL_DELEGATE_API_KEY` | *(vacío)* | Bearer token, si tu endpoint lo exige |
+| `LOCAL_DELEGATE_TIMEOUT` | `180` | Timeout HTTP (segundos) |
+| `LOCAL_DELEGATE_LOG` | *(dir de datos de usuario)* | Ruta del `usage.jsonl` |
+| `LOCAL_DELEGATE_MODEL_MECHANICAL` | `gemma3-4b` | Modelo para clasificar/extraer/resumen corto |
+| `LOCAL_DELEGATE_MODEL_LONG` | `llama31-8b` | Modelo para documentos largos |
+| `LOCAL_DELEGATE_MODEL_CODE` | `qwen25-coder-14b` | Modelo para código |
+| `LOCAL_DELEGATE_MODEL_FAST` | `qwen35-2b` | Modelo ultrarrápido / trivial |
+| `LOCAL_DELEGATE_LONG_INPUT_CHARS` | `6000` | Umbral mecánico↔largo |
+| `LOCAL_DELEGATE_WEB` | `1` | Web de métricas embebida (`0` para desactivar) |
+| `LOCAL_DELEGATE_WEB_HOST` / `_PORT` | `127.0.0.1` / `9393` | Host/puerto de la web |
+| `LOCAL_DELEGATE_AUTOSTART` | `0` | Auto-arranque de llama-swap (opt-in) |
+| `LLAMASWAP_EXE` / `LLAMASWAP_CONFIG` / `LLAMASWAP_LISTEN` | — | Solo si `AUTOSTART=1` |
+
+## La métrica de ahorro
+
+El MCP registra cada llamada en `usage.jsonl` y sirve un **dashboard** en
+`http://127.0.0.1:9393`. El *ahorro de contexto* = caracteres de entrada leídos server-side
+(llamadas con `source=path`) ÷ 4 ≈ tokens que nunca entraron al contexto de Claude.
+Detalle en la [wiki](https://github.com/ZahiriNatZuke/local-delegate/wiki) *(en construcción)*.
+
+## Enlaces
+
+- [Wiki](https://github.com/ZahiriNatZuke/local-delegate/wiki) · [Recipes](./docs/recipes)
+- [CONTRIBUTING](./CONTRIBUTING.md) · [CODE OF CONDUCT](./CODE_OF_CONDUCT.md) · [CHANGELOG](./CHANGELOG.md)
+- [Licencia MIT](./LICENSE)

local_delegate_mcp-0.1.0/README.md

@@ -0,0 +1,103 @@
+<!-- mcp-name: io.github.ZahiriNatZuke/local-delegate -->
+
+# local-delegate
+
+**Delega tareas mecánicas texto→texto a un LLM local para conservar la cuota de tu suscripción de Claude.**
+Un servidor MCP (stdio) que es cliente **genérico** de cualquier endpoint OpenAI-compatible —
+llama-swap, Ollama, LM Studio, vLLM.
+
+[![PyPI](https://img.shields.io/pypi/v/local-delegate-mcp.svg)](https://pypi.org/project/local-delegate-mcp/)
+[![CI](https://github.com/ZahiriNatZuke/local-delegate/actions/workflows/ci.yml/badge.svg)](https://github.com/ZahiriNatZuke/local-delegate/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+
+## ¿Por qué?
+
+Cuando Claude tiene que resumir un log enorme, clasificar, extraer campos o generar boilerplate,
+gasta cuota de tu suscripción en trabajo **mecánico**. `local-delegate` expone esas tareas como
+tools MCP que corren en un LLM **local**: pasas `path` en vez de `text` y el archivo se lee
+**del lado del servidor**, así el contenido grande **nunca entra al contexto de Claude**. Solo
+vuelve el resultado corto — cuota que no gastaste.
+
+## Instalación rápida
+
+Con [`uv`](https://docs.astral.sh/uv/) no hay nada que instalar: `uvx` baja y ejecuta el paquete aislado.
+
+Añádelo a tu config de MCP (Claude Desktop / Claude Code):
+
+```json
+{
+  "mcpServers": {
+    "local-delegate": {
+      "command": "uvx",
+      "args": ["local-delegate-mcp"]
+    }
+  }
+}
+```
+
+Ver plantillas completas en [`examples/`](./examples).
+
+## Requisitos
+
+Un **endpoint OpenAI-compatible** ya corriendo, accesible en `LOCAL_DELEGATE_BASE_URL`
+(default `http://127.0.0.1:9292/v1`). Cualquiera sirve:
+
+- **llama-swap** — ver [recipe con GPU Blackwell](./docs/recipes/) *(en construcción)*.
+- **Ollama** — `http://127.0.0.1:11434/v1`.
+- **LM Studio**, **vLLM**, o cualquier servidor que hable la API de OpenAI.
+
+El paquete **no arranca** ningún backend por defecto (`LOCAL_DELEGATE_AUTOSTART=0`). El
+auto-arranque de llama-swap es opt-in (ver tabla de configuración).
+
+## Tools
+
+Pasar `path` (en vez de `text`) hace que el MCP lea el archivo server-side → ahorro real de cuota.
+
+| Tool | Qué hace | Rol de modelo (default) |
+|---|---|---|
+| `local_summarize` | Resume texto o archivo | mecánico / largo (auto) |
+| `local_classify` | Devuelve UNA etiqueta de una lista | mecánico |
+| `local_extract` | Extrae campos → objeto JSON | mecánico |
+| `local_boilerplate` | Genera código desde una spec | código |
+| `local_delegate` | Escape genérico texto→texto | mecánico (o el que pases) |
+| `local_lint_summary` | Resume logs de lint/tests/CI | mecánico / largo (auto) |
+| `local_commit_msg` | Mensaje de commit desde un diff | código |
+| `local_translate` | Traduce texto o archivo | mecánico / largo (auto) |
+| `local_explain_code` | Explica código en prosa | código |
+
+Los modelos locales **no** usan tool-calling: el server arma el prompt + guardrails, hace POST al
+endpoint y devuelve **solo texto**.
+
+## Configuración
+
+Todo por variables de entorno; nada hardcodeado. Los ids de modelo default son solo eso —
+cámbialos por los de tu backend.
+
+| Variable | Default | Descripción |
+|---|---|---|
+| `LOCAL_DELEGATE_BASE_URL` | `http://127.0.0.1:9292/v1` | Endpoint OpenAI-compatible |
+| `LOCAL_DELEGATE_API_KEY` | *(vacío)* | Bearer token, si tu endpoint lo exige |
+| `LOCAL_DELEGATE_TIMEOUT` | `180` | Timeout HTTP (segundos) |
+| `LOCAL_DELEGATE_LOG` | *(dir de datos de usuario)* | Ruta del `usage.jsonl` |
+| `LOCAL_DELEGATE_MODEL_MECHANICAL` | `gemma3-4b` | Modelo para clasificar/extraer/resumen corto |
+| `LOCAL_DELEGATE_MODEL_LONG` | `llama31-8b` | Modelo para documentos largos |
+| `LOCAL_DELEGATE_MODEL_CODE` | `qwen25-coder-14b` | Modelo para código |
+| `LOCAL_DELEGATE_MODEL_FAST` | `qwen35-2b` | Modelo ultrarrápido / trivial |
+| `LOCAL_DELEGATE_LONG_INPUT_CHARS` | `6000` | Umbral mecánico↔largo |
+| `LOCAL_DELEGATE_WEB` | `1` | Web de métricas embebida (`0` para desactivar) |
+| `LOCAL_DELEGATE_WEB_HOST` / `_PORT` | `127.0.0.1` / `9393` | Host/puerto de la web |
+| `LOCAL_DELEGATE_AUTOSTART` | `0` | Auto-arranque de llama-swap (opt-in) |
+| `LLAMASWAP_EXE` / `LLAMASWAP_CONFIG` / `LLAMASWAP_LISTEN` | — | Solo si `AUTOSTART=1` |
+
+## La métrica de ahorro
+
+El MCP registra cada llamada en `usage.jsonl` y sirve un **dashboard** en
+`http://127.0.0.1:9393`. El *ahorro de contexto* = caracteres de entrada leídos server-side
+(llamadas con `source=path`) ÷ 4 ≈ tokens que nunca entraron al contexto de Claude.
+Detalle en la [wiki](https://github.com/ZahiriNatZuke/local-delegate/wiki) *(en construcción)*.
+
+## Enlaces
+
+- [Wiki](https://github.com/ZahiriNatZuke/local-delegate/wiki) · [Recipes](./docs/recipes)
+- [CONTRIBUTING](./CONTRIBUTING.md) · [CODE OF CONDUCT](./CODE_OF_CONDUCT.md) · [CHANGELOG](./CHANGELOG.md)
+- [Licencia MIT](./LICENSE)