mcp-lint

Name: mcp-lint
Author: robert19001-cmyk

de robert19001-cmykversión 1.0.4i★ 1iSe ejecuta en tu computadora

Nombre en el registroio.github.robert19001-cmyk/mcp-lint

Cómo instalar

Resumen

Descripción del creador (original en inglés)

Lint MCP tool schemas for eight clients and score recovery.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 2/2 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

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

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa mcp-lint y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando mcp-lint o muestra una herramienta de mcp-lint en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar mcp-lint

mcp-lint se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar mcp-lint

Pasos para Claude →Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Instala Node.js en tu computadora primero (una sola vez)
Pasos para Cursor →Instala Node.js en tu computadora primero (una sola vez)
Pasos para VS Code →Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho
3
Pega este comando y pulsa Enter
```
claude mcp add lint -- npx -y mcp-lint
```
Hecho
Escribe /mcp en Claude Code
Deberías ver mcp-lint en la lista como conectado
Hecho
Pruébalo
Usa mcp-lint y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando mcp-lint o muestra una herramienta de mcp-lint en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa mcp-lint y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando mcp-lint o muestra una herramienta de mcp-lint en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa mcp-lint y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando mcp-lint o muestra una herramienta de mcp-lint en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa mcp-lint💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add lint -- npx -y mcp-lint

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "lint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-lint"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 1
Descargas por semanai: 1068/sem
Licencia i: Sin licencia indicada
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 1.0.4
Categoríai: Otros
Publicado en el registroi: 7 nov 2026
Último cambio de códigoi: 7 nov 2026
Creador: robert19001-cmyk
Paquetes: npm: mcp-lint
Repo: robert19001-cmyk/mcp-lint
Sitio web: mcp-lint-alpha.vercel.app
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 12 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub robert19001-cmyk, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 5 días
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Otrosi

Más estrellas que el 86% de los otros 19280 servidores de esta categoría
Publicado en el registro más recientemente que el 89% de los otros 19280 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 19280 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro mcp-lint?

Superó 2 de 2 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 5 días, y la última versión (1.0.4) llegó al registro hace 5 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, Claude Flow, Tldraw

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

de koala73Muy usado★ 90,5 milActualizado hoy

Se ejecuta en la nube✓ worldmonitor.app

Instalar

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

de ruvnetMuy usado↓ 13,5 mil/sem★ 81,5 milActualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

de tldrawMuy usado★ 51,4 milActualizado hace 8 meses

Se ejecuta en la nube

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

mcp-lint

Lint MCP server tool schemas, then check whether an agent can recover when a tool fails.

Proof page, with a live bench: mcp-lint-alpha.vercel.app

MCP servers expose tool schemas consumed by Claude, Cursor, Gemini, VS Code Copilot, Windsurf, Cline, OpenAI Agents SDK, and Continue.dev. Each client has different JSON Schema support and quirks — a schema that works in Claude may silently break in Cursor or OpenAI. mcp-lint catches these issues before your users do.

This repository is 1.0.4. Install it with npx mcp-lint@1.0.4. npm 1.0.3 is the previous registry release. npm 1.0.1 and npm 1.0.2 were not published. Design notes: PRODUCT.md, ROADMAP.md, ARCHITECTURE.md, SECURITY.md, RELEASE.md. Those files describe the current code. They are not extra commands.

$ npx mcp-lint check tools.json

search-tool ✖ Schema node at "inputSchema.properties.query" has required: false which is not valid JSON Schema. inputSchema.properties.query [no-required-false] ⚠ Parameter "limit" in tool "search-tool" is missing a description. inputSchema.properties.limit [description-exists]

1 error, 1 warning Next: mcp-lint explain no-required-false mcp-lint fix tools.json --dry-run

Installation

# In a repo that already has tools.json

npx mcp-lint

Or point at a file

npx mcp-lint check tools.json

Global

npm install -g mcp-lint

Per-project dev dependency

npm install --save-dev mcp-lint

Quick Start

# Look in this directory, and one level down, for tools.json, tools.yaml,

tools.yml, mcp-tools.json, mcp-tools.yaml, or mcp-tools.yml

npx mcp-lint

Check a JSON or YAML file

mcp-lint check tools.json

See compatibility across all clients at a glance

mcp-lint compat tools.json

Learn what a rule does

mcp-lint explain openai/no-additional-properties

Auto-fix what can be fixed

mcp-lint fix tools.json --in-place

Generate a config file

mcp-lint init

Run as an MCP server

mcp-lint-server

Score whether a tool failure tells the agent which tool to call next

mcp-lint recover examples/recover/bad-credential.json

Lint the stdio servers already configured for Cursor, Claude, and VS Code

mcp-lint check --installed

Save a live tool list, then fail CI when a later snapshot gets worse

mcp-lint snapshot -o tools.json --server stdio -- node server.js mcp-lint diff tools.json tools.next.json

`mcp-lint compat` — Compatibility Matrix

See exactly which tools work with which clients:

$ mcp-lint compat tools.json

claude cursor gemini vscode windsurf cline openai continue search-tool ✓ ✗ ✓ ✓ ✓ ✓ ✓ ✓ file-reader ✓ ✓ ✗ ✓ ✓ ✓ ✓ ✗ database-query ✓ ✓ ✓ ✓ ✓ ✓ ✗ ✓

2 tools have compatibility issues. Run mcp-lint check for details.

mcp-lint compat tools.json --format markdown         # for PRs and GitHub Step Summary

mcp-lint compat tools.json --format json # machine-readable mcp-lint compat tools.json --client openai # single client column mcp-lint compat --server stdio -- node server.js

`mcp-lint explain` — Rule Documentation

$ mcp-lint explain openai/no-additional-properties

Rule: openai/no-additional-properties Severity: error Clients: openai Fix: review mcp-lint fix lists this and does not write it.

Description OpenAI Agents SDK strict mode requires additionalProperties: false on the root inputSchema.

Why OpenAI's strict function calling mode rejects schemas that don't explicitly set additionalProperties: false at the root level.

Bad example { "type": "object", "properties": { "q": { "type": "string" } } }

Good example { "type": "object", "properties": { "q": { "type": "string" } }, "additionalProperties": false }

Change Add "additionalProperties": false to the root inputSchema.

CLI Reference

`mcp-lint check [input]`

mcp-lint check tools.json

Output formats

mcp-lint check tools.json --format terminal # default, colored output mcp-lint check tools.json --format json # machine-readable (CI/CD) mcp-lint check tools.json --format markdown # for PRs and GitHub summaries

Filters

mcp-lint check tools.json --clients claude,cursor,openai # only these clients' rules mcp-lint check tools.json --severity error # errors only mcp-lint check tools.json --quiet # same as --severity error mcp-lint check tools.json --ignore "debug-tool,internal-tool"

Config

mcp-lint check tools.json --config path/to/.mcplintrc.json mcp-lint check tools.json --no-color

Quality score (0–100 per tool with A-F grades)

mcp-lint check tools.json --score

Watch mode (re-lints on file change)

mcp-lint check tools.json --watch

Live servers

mcp-lint check --server stdio -- node my-server.js mcp-lint check --server stdio -- python my_server.py arg1 arg2 mcp-lint check --server sse --url http://localhost:3000/sse

Exit codes:

Code	Meaning
`0`	No schema errors. Warnings do not fail the command.
`1`	One or more schema errors, or the command could not read its input.
`2`	`--watch` was used without a file.

`mcp-lint report`

Writes the versioned audit report for one tools file. check --format json still prints the diagnostic array. report --format json prints MCPAuditReport.

mcp-lint report tools.json

mcp-lint report tools.json --format sarif --output results.sarif mcp-lint report tools.json --format html --output report.html mcp-lint report tools.json --format markdown

Formats are terminal, json, markdown, sarif, and html. The HTML file has inline CSS and no script. Token totals are a local chars / 4 estimate. The compatibility section is filled from that same lint. A cell is measured or not_observed. An empty tool list leaves the section not run. Recovery, preflight, and live inspection stay marked as not run. When the run has no schema errors, the report says: "No schema errors in this run. Recovery, preflight, and live inspection were not measured."

mcp-lint report tools.json --baseline audit.baseline.json

mcp-lint report tools.json --update-baseline audit.baseline.json

--baseline exits 1 when the stable snapshot differs. The snapshot pins generatedAt and keeps tool.version. Pass either --baseline or --update-baseline, not both. Exit 1 when the report contains an error, or when the file cannot be read.

`mcp-lint catalog`

Lists resources and prompts from one live server, then lints that list. It does not read installed configs and it does not call a tool. An empty or repeated URI, an empty resource name, an empty or repeated prompt name, and an empty or repeated argument name are errors and exit 1. A repeated resource display name, and a missing description, are warnings and do not. explain prints the rule. The fix class is manual: the command does not rewrite the server.

mcp-lint catalog --server stdio -- node server.js

mcp-lint catalog --server http --url https://example.com/mcp --format json

--server is stdio, sse, or http. Remote transports need --url. --timeout, --max-items, and --max-bytes bound each list. A method the server does not implement is unsupported and exits 0. Any other list failure exits 1. A lint error also exits 1. Usage errors exit 2. --format is terminal or json. JSON adds a findings array to the list. The array is empty when the list is clean.

`mcp-lint diff`

Compare lint results between two versions of your schema — useful in CI to catch regressions.

mcp-lint diff tools-v1.json tools-v2.json

mcp-lint diff tools-v1.json tools-v2.json --format markdown >> $GITHUB_STEP_SUMMARY mcp-lint diff tools-v1.json tools-v2.json --format json

Exit codes: 0 = no new errors introduced, 1 = new errors found, 2 = error

`mcp-lint check --installed`

Reads the MCP configs already on this machine and lints each local stdio server. Nothing is uploaded. Remote URLs are skipped unless you pass --remote.

mcp-lint check --installed

mcp-lint check --from .cursor/mcp.json mcp-lint check --from .mcp.json --timeout 10000 --strict

Looked-up files:

Client	Path
Cursor	`~/.cursor/mcp.json` and `./.cursor/mcp.json`
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
Claude Code	`~/.claude.json`, `~/.claude/settings.json`, and `./.mcp.json`. `~/.claude.json` also contributes each `projects. .mcpServers` entry.
VS Code	`~/Library/Application Support/Code/User/mcp.json` and `./.vscode/mcp.json`

--strict also exits 1 when a configured server fails to start. Without it, a start failure is printed and the exit code follows the schema errors. If two started servers expose the same tool name, both reports include tool-name/server-collision.

`mcp-lint snapshot`

Writes the live tools/list as a stable JSON file. Commit that file and compare it with diff when the server changes. diff exits 1 when the new file introduces an error the old file did not have.

mcp-lint snapshot -o tools.json --server stdio -- node server.js

mcp-lint snapshot -o tools.json --server http --url http://127.0.0.1:3000/mcp mcp-lint diff tools.json tools.next.json

`mcp-lint fix [input]`

Writes fixes marked safe. review and manual fixes are printed by --dry-run and left in the file. mcp-lint does not invent titles, descriptions, or hints.

mcp-lint fix tools.json                            # fixed output to stdout

mcp-lint fix tools.json --output fixed-tools.json # write to file mcp-lint fix tools.json --in-place # overwrite original mcp-lint fix tools.json --dry-run # show what would be fixed mcp-lint fix tools.json --rules no-required-false,no-empty-enum # specific rules only

`mcp-lint init`

Creates a default .mcplintrc.json in the current directory.

mcp-lint init          # fails if file already exists

mcp-lint init --force # overwrite existing

Rules

Universal (all clients)

Rule	Severity	Fixable	Description
`no-required-false`	🔴 error	✅	`required: false` on properties is not valid JSON Schema
`no-content-encoding`	🔴 error	✅	`contentEncoding` is not supported by MCP clients
`no-empty-enum`	🔴 error	✅	Empty `enum: []` makes a parameter impossible to satisfy
`no-recursive-refs`	🔴 error	❌	Circular `$ref` causes crashes in most clients
`valid-json-schema-subset`	🔴 error	❌	Unsupported keywords: `oneOf`, `anyOf`, `allOf`, `if/then/else`, `not`, `patternProperties`…
`description-exists`	🟡 warning	❌	Tools and parameters should have descriptions

| max-depth | 🟡 warning | ❌ | Schema nesting deeper than 5 levels

Solo se muestra el principio; lee el resto en el repo

mcp-lint

Resumen

Qué puedes hacer con él

Instalación

Instala Node.js

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala Node.js

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala Node.js

Pulsa este botón para abrir Cursor

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala Node.js

Pulsa este botón para abrir VS Code

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Conversación

Reseñas de usuarios

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

World Monitor

Claude Flow

Tldraw

README del creador

mcp-lint

Installation

Or point at a file

Global

Per-project dev dependency

Quick Start

tools.yml, mcp-tools.json, mcp-tools.yaml, or mcp-tools.yml

Check a JSON or YAML file

See compatibility across all clients at a glance

Learn what a rule does

Auto-fix what can be fixed

Generate a config file

Run as an MCP server

Score whether a tool failure tells the agent which tool to call next

Lint the stdio servers already configured for Cursor, Claude, and VS Code

Save a live tool list, then fail CI when a later snapshot gets worse

mcp-lint compat — Compatibility Matrix

mcp-lint explain — Rule Documentation

CLI Reference

mcp-lint check [input]

Output formats

Filters

Config

Quality score (0–100 per tool with A-F grades)

Watch mode (re-lints on file change)

Live servers

mcp-lint report

mcp-lint catalog

mcp-lint diff

mcp-lint check --installed

mcp-lint snapshot

mcp-lint fix [input]

mcp-lint init

Rules

Universal (all clients)

`mcp-lint compat` — Compatibility Matrix

`mcp-lint explain` — Rule Documentation

`mcp-lint check [input]`

`mcp-lint report`

`mcp-lint catalog`

`mcp-lint diff`

`mcp-lint check --installed`

`mcp-lint snapshot`

`mcp-lint fix [input]`

`mcp-lint init`