Tether MCP

Tether MCP

O motor anti-deriva para agentes de codificação de IA.
_{Dê à sua IA memória persistente das regras do seu projeto. Um comando. Zero nuvem.}

Agentes de IA como Cursor e Claude escrevem código rápido — mas sofrem de Deriva de Agente: alucinam dependências, violam limites arquiteturais e criam código espaguete. Tether é um Arquiteto Sênior persistente que sua IA deve consultar antes de fazer mudanças estruturais.

Sumário

• O Problema
• Início Rápido
• Como Funciona
• Ferramentas
• Recursos MCP
• Comandos CLI
• Configuração
• Níveis de Severidade de Dependências
• O Registro de Decisões
• Telemetria de Sessão
• Frameworks Suportados
• Referência de Configuração
• FAQ
• Contribuindo
• Licença

O Problema

Você já passou por isso. Você pede a um agente de IA para adicionar um recurso e ele:

• 🎲 Instala moment.js quando seu projeto já usa date-fns
• 🏗️ Cria um servidor Express dentro do seu app Next.js
• 🧩 Adiciona Riverpod quando seu time Flutter concordou em usar BLoC
• 📝 Esquece toda a arquitetura depois de algumas mensagens

Cada sessão começa do zero. A IA não tem memória das suas regras, das suas decisões de stack ou dos seus limites arquiteturais. Isso é Deriva de Agente, e transforma codificação assistida por IA em uma fábrica de dívida técnica.

Início Rápido

1. Inicialize no Seu Projeto

npx tether-mcp init

Tether escaneia o manifesto do seu projeto (package.json, pubspec.yaml, .csproj, pyproject.toml, go.mod, Cargo.toml, build.gradle, pom.xml, ou Package.swift), detecta automaticamente seu framework em 8 ecossistemas e 90 frameworks, e gera um tether.config.json personalizado com padrões inteligentes.

2. Conecte ao Seu 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. Pronto. Seu Agente de IA Agora Tem Guardrails ⚓

Toda vez que a IA começa a trabalhar, ela consulta o Tether primeiro — lendo seus invariantes, verificando políticas de dependências, validando posicionamento de arquivos e registrando decisões estruturais. Sem mais deriva.

Como Funciona

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

Ferramentas (6 no total)

Recursos MCP

Tether também expõe o contexto do projeto como Recursos MCP que os clientes podem assinar automaticamente:

Configuração

Edite o tether.config.json para corresponder ao seu projeto:

{
  "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

Níveis de Severidade de Dependências

Dependências bloqueadas agora suportam níveis de severidade:

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

O Que É Gerado

Quando você executa npx tether-mcp init em um projeto Next.js + Prisma + Tailwind, o Tether gera:

{
  "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"] }
    ]
  }
}

O Registro de Decisões

Toda decisão estrutural que a IA toma é registrada no 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.

Isso cria uma trilha de auditoria imutável de cada escolha arquitetural — visível para o próximo desenvolvedor e para a próxima sessão de IA.

Telemetria de Sessão

A ferramenta health_check retorna estatísticas locais de sessão:

{
  "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 }
    }
  }
}

Nenhum dado sai da sua máquina. A telemetria é redefinida quando o servidor reinicia.

Detecção de Frameworks Suportados

Tether detecta automaticamente 90 frameworks em 8 ecossistemas:

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 detecção adiciona invariantes direcionados e regras inteligentes de pacotes bloqueados específicos para seu stack.

Referência de Configuração

FAQ

Contribuindo

Contribuições são bem-vindas! Aqui estão algumas formas de ajudar:

• Adicione uma assinatura de framework — detecte um novo framework no src/utils/detect-stack.ts
• Melhore invariantes — melhores padrões para frameworks existentes
• Relatórios de bugs — abra uma issue
• Solicitações de recursos — ideias para novas ferramentas ou recursos

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

Licença

MIT — feito com ♥ para desenvolvedores cansados de limpar a bagunça dos seus agentes de IA.