mcp-lint

Name: mcp-lint
Author: robert19001-cmyk

제작자: robert19001-cmyk버전 1.0.4i★ –i내 컴퓨터에서 실행

레지스트리 이름io.github.robert19001-cmyk/mcp-lint

설치

개요

제작자가 쓴 설명(영어 원문)

Lint MCP tool schemas for eight clients and score recovery.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견i아직 리뷰가 없어요리뷰는 다음 단계에서 계정 기능과 함께 열려요
우리의 기본 점검i1개 중 1개 통과공개된 정보로 점검했으며, 코드는 아직 스캔하지 않았어요
사용 정도i초기↓ 1.6천/주 · ★ –

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

연결 방식: 내 컴퓨터에서 실행
전송 방식: stdio
카테고리: 기타

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

기본 점검: 1개 중 1개 통과
내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
레지스트리에 입력해야 할 키가 나와 있지 않아요.

필요한 것

npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

ClaudeClaude CodeCursorVS CodeChatGPT

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요

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

터미널에서 이 명령어를 실행하세요

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

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 9일 점검

✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 robert19001-cmyk 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
… 아직 점검 안 함
계속 관리되고 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
… 아직 점검 안 함
라이선스 있음
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
– 해당 없음
엔드포인트 응답
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
– 해당 없음
OAuth로 로그인
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
… 아직 점검 안 함
도구 설명에 숨겨진 지시 없음
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

이 카테고리의 다른 서버 18728개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 18728개 중 93%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 18728개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

mcp-lint, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.0.4)은 3일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Shield Kya

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

제작자: formulahendry초기↓ 66/주★ 44014개월 전 업데이트

내 컴퓨터에서 실행

설치

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

제작자: desktop-commander성장 중★ 2114일 전 업데이트

클라우드에서 실행✓ desktopcommander.app

설치

Shield Kya

Audit trail and traceability for AI agents. MCP gate: evaluate, ingest, request approval.

제작자: The-Pixel-Boys초기↓ 1.3천/주오늘 업데이트

내 컴퓨터에서 실행

설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

mcp-lint

개요

PopNx MCP의 세 기둥

할 수 있는 일

설치

설치하기 전에

할 수 있는 일

기본 점검i

제작자와 저장소 일치

계속 관리되고 있음

라이선스 있음

엔드포인트 응답

OAuth로 로그인

도구 설명에 숨겨진 지시 없음

기타 카테고리의 다른 서버와 비교i

자주 묻는 질문

대안

Spec Driven Development

Remote Desktop Commander

Shield Kya

제작자의 README

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`