Tether MCP

Tether MCP

El motor anti-deriva para agentes de codificación con IA.
_{Dale a tu IA memoria persistente de las reglas de tu proyecto. Un comando. Cero nube.}

Los agentes de IA como Cursor y Claude escriben código rápido, pero sufren de Deriva de Agente: alucinan dependencias, violan límites arquitectónicos y crean código espagueti. Tether es un Arquitecto Senior persistente que tu IA debe consultar antes de realizar cambios estructurales.

Tabla de contenidos

• El problema
• Inicio rápido
• Cómo funciona
• Herramientas
• Recursos MCP
• Comandos CLI
• Configuración
• Niveles de severidad de dependencias
• El registro de decisiones
• Telemetría de sesión
• Frameworks compatibles
• Referencia de configuración
• Preguntas frecuentes
• Contribuciones
• Licencia

El problema

Ya has estado ahí. Le pides a un agente de IA que agregue una función y:

• 🎲 Instala moment.js cuando tu proyecto ya usa date-fns
• 🏗️ Crea un servidor Express dentro de tu aplicación Next.js
• 🧩 Agrega Riverpod cuando tu equipo de Flutter acordó usar BLoC
• 📝 Olvida toda la arquitectura después de unos mensajes

Cada sesión comienza desde cero. La IA no tiene memoria de tus reglas, tus decisiones de stack o tus límites arquitectónicos. Esto es Deriva de Agente, y convierte la codificación asistida por IA en una fábrica de deuda técnica.

Inicio rápido

1. Inicializa en tu proyecto

npx tether-mcp init

Tether escanea el manifiesto de tu proyecto (package.json, pubspec.yaml, .csproj, pyproject.toml, go.mod, Cargo.toml, build.gradle, pom.xml, o Package.swift), detecta automáticamente tu framework en 8 ecosistemas y 90 frameworks, y genera un tether.config.json personalizado con valores predeterminados inteligentes.

2. Conecta a tu agente de IA

{
  "mcpServers": {
    "tether": {
      "command": "npx",
      "args": ["-y", "tether-mcp"]
    }
  }
}

{
  "mcpServers": {
    "tether": {
      "command": "npx",
      "args": ["-y", "tether-mcp"]
    }
  }
}

{
  "mcpServers": {
    "tether": {
      "command": "npx",
      "args": ["-y", "tether-mcp"]
    }
  }
}

3. Listo. Tu agente de IA ahora tiene protecciones ⚓

Cada vez que la IA comienza a trabajar, consulta a Tether primero: lee tus invariantes, verifica políticas de dependencias, valida ubicaciones de archivos y registra decisiones estructurales. No más deriva.

Cómo funciona

┌──────────────┐     MCP Tools     ┌──────────────┐     Local Files     ┌──────────────────┐
│  AI Agent    │ ◄──────────────► │  Tether MCP  │ ◄─────────────────► │ tether.config.json│
│ (Claude,     │                  │  Server      │                     │ ARCHITECTURE.md   │
│  Cursor)     │                  │              │                     │ DECISIONS.md      │
└──────────────┘                  └──────────────┘                     └──────────────────┘

Herramientas (6 en total)

Recursos MCP

Tether también expone el contexto del proyecto como Recursos MCP a los que los clientes pueden suscribirse automáticamente:

Configuración

Edita tether.config.json para que coincida con tu proyecto:

{
  "projectName": "my-app",
  "techStack": {
    "frontend": ["Next.js", "React"],
    "backend": ["Node.js"],
    "orm": ["Prisma"]
  },
  "invariants": [
    "All API routes must validate input with Zod.",
    "Database access must go through Prisma — no raw SQL.",
    "Use Server Components by default — client components only when needed."
  ],
  "dependencies": {
    "blocked": [
      {
        "name": "moment",
        "reason": "Use date-fns instead.",
        "alternatives": ["date-fns"],
        "severity": "block"
      },
      {
        "name": "lodash",
        "reason": "Tree-shaking issues. Use native JS or lodash-es.",
        "alternatives": ["lodash-es", "remeda"],
        "severity": "warn"
      }
    ]
  },
  "fileStructure": [
    {
      "pattern": "component",
      "allowedPaths": ["src/components/", "src/app/"],
      "reason": "All React components must live in src/components/ or src/app/"
    },
    {
      "pattern": "api-route",
      "allowedPaths": ["src/app/api/"],
      "reason": "API routes must use Next.js Route Handlers in app/api/"
    }
  ],
  "codePatterns": [
    {
      "name": "State Management",
      "rule": "Use React Context + useReducer for complex state — no Redux or Zustand",
      "scope": "frontend/state"
    },
    {
      "name": "Data Fetching",
      "rule": "Use Server Components for data fetching — no client-side fetch in components",
      "scope": "frontend"
    }
  ]
}

Comandos CLI

npx tether-mcp init       # Scan project & generate tether.config.json
npx tether-mcp serve      # Start the MCP server (stdio)
npx tether-mcp status     # Show project config summary & health
npx tether-mcp validate   # Validate tether.config.json against schema
npx tether-mcp --version  # Show version
npx tether-mcp --help     # Show all commands

Niveles de severidad de dependencias

Las dependencias bloqueadas ahora admiten niveles de severidad:

{
  "dependencies": {
    "blocked": [
      { "name": "moment", "reason": "Deprecated.", "alternatives": ["date-fns"], "severity": "block" },
      { "name": "axios", "reason": "Prefer native fetch.", "alternatives": ["fetch"], "severity": "warn" }
    ]
  }
}

Qué se genera

Cuando ejecutas npx tether-mcp init en un proyecto Next.js + Prisma + Tailwind, Tether genera:

{
  "projectName": "my-next-app",
  "techStack": {
    "frontend": ["Next.js", "React"],
    "styling": ["Tailwind CSS"],
    "orm": ["Prisma"],
    "language": ["TypeScript"]
  },
  "invariants": [
    "Use Next.js App Router for all new routes — do not use the Pages Router.",
    "All database access must go through Prisma — no raw SQL queries.",
    "Use Tailwind utility classes for styling — no inline styles.",
    "All new code must be written in TypeScript with strict mode enabled."
  ],
  "dependencies": {
    "blocked": [
      { "name": "express", "reason": "Next.js has built-in API routes.", "alternatives": ["Next.js Route Handlers"] },
      { "name": "moment",  "reason": "Deprecated and large bundle size.", "alternatives": ["date-fns"] }
    ]
  }
}

El registro de decisiones

Cada decisión estructural que toma la IA se registra en DECISIONS.md:

## Added Redis caching layer

| Field | Value |
|-------|-------|
| **Date** | 2026-03-10T01:30:00.000Z |
| **Scope** | `api/cache` |

### Summary

Added Redis via ioredis for caching frequently accessed product data.
Chose Redis over Memcached for pub/sub support and persistence options.

Esto crea un rastro de auditoría inmutable de cada elección arquitectónica, visible para el próximo desarrollador y la próxima sesión de IA.

Telemetría de sesión

La herramienta health_check devuelve estadísticas de sesión solo locales:

{
  "status": "healthy",
  "session": {
    "sessionStartedAt": "2026-03-12T10:00:00.000Z",
    "totalCalls": 7,
    "toolStats": {
      "get_project_invariants": { "callCount": 3, "lastCalledAt": "...", "errors": 0 },
      "verify_dependency_addition": { "callCount": 2, "lastCalledAt": "...", "errors": 0 }
    }
  }
}

Ningún dato sale de tu máquina. La telemetría se restablece cuando el servidor se reinicia.

Detección de frameworks compatibles

Tether detecta automáticamente 90 frameworks en 8 ecosistemas:

JavaScript / TypeScript (package.json)

Python (pyproject.toml, requirements.txt)

Dart / Flutter (pubspec.yaml)

C# / .NET (.csproj)

Go (go.mod)

Rust (Cargo.toml)

Java / Kotlin (build.gradle, pom.xml)

Swift (Package.swift)

Cada detección agrega invariantes específicos y reglas inteligentes de paquetes bloqueados específicos para tu stack.

Referencia de configuración

Preguntas frecuentes

Contribuciones

¡Las contribuciones son bienvenidas! Aquí hay algunas formas de ayudar:

• Agregar una firma de framework — detecta un nuevo framework en src/utils/detect-stack.ts
• Mejorar invariantes — mejores valores predeterminados para frameworks existentes
• Informes de errores — abre un issue
• Solicitudes de funciones — ideas para nuevas herramientas o recursos

git clone https://github.com/MoayadEsam/tether-mcp.git
cd tether-mcp
npm install
npm run build

Licencia

MIT — hecho con ♥ para desarrolladores que están cansados de limpiar después de sus agentes de IA.