MCP Surface Lint

Statically audits MCP tool surfaces for token cost, schema quality, and design issues.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
83%
이름 품질
100%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~904토큰 (도구 정의)
~9.8 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 0.71%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "mcp-surface-lint": {
      "url": "https://mcplint-web.vercel.app/api/mcp"
    }
  }
}

원격 엔드포인트

https://mcplint-web.vercel.app/api/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (1)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢check_mcp_server(url, headers, snapshot)

Statically audit an MCP tool surface from a public HTTPS URL or tools/list snapshot. Returns deterministic scores and findings without invoking any target tool or making LLM calls. When the user asks to check another installed MCP server, read that server's complete tool definitions from client context and pass them as snapshot (MCP `name` or Cursor-style `tool` both work; do not use file paths or $ref). If those definitions are unavailable, ask the user for its public endpoint or tools/list JSON instead of inventing an audit.

입력 스키마

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "description": "Public HTTPS Streamable HTTP MCP endpoint to inspect."
    },
    "headers": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Optional HTTP headers sent only while reading the remote tools/list response."
    },
    "snapshot": {
      "description": "A tools/list JSON response, MCP Surface Lint snapshot, or client tool dump containing a tools array. Each tool needs `name`, or the Cursor-style `tool` alias. Forward another installed server's complete tool definitions here — do not invent schemas."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

출력 스키마

{
  "type": "object",
  "properties": {
    "staticAnalysis": {
      "type": "boolean",
      "const": true
    },
    "targetToolsInvoked": {
      "type": "boolean",
      "const": false
    },
    "grade": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "F"
      ]
    },
    "server": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "version": {
          "type": "string"
        }
      },
      "additionalProperties": false
    },
    "source": {
      "type": "string"
    },
    "stats": {
      "type": "object",
      "properties": {
        "toolCount": {
          "type": "integer",
          "minimum": 0
        },
        "approxTokens": {
          "type": "integer",
          "minimum": 0
        },
        "encoding": {
          "type": "string"
        }
      },
      "required": [
        "toolCount",
        "approxTokens",
        "encoding"
      ],
      "additionalProperties": false
    },
    "scores": {
      "type": "object",
      "properties": {
        "composite": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100
        },
        "categories": {
          "type": "object",
          "properties": {
            "surface": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "naming": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "descriptions": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "schemas": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "annotations": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            },
            "design": {
              "type": "integer",
              "minimum": 0,
              "maximum": 100
            }
          },
          "required": [
            "surface",
            "naming",
            "descriptions",
            "schemas",
            "annotations",
            "design"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "composite",
        "categories"
      ],
      "additionalProperties": false
    },
    "findingCounts": {
      "type": "object",
      "properties": {
        "bySeverity": {
          "type": "object",
          "properties": {
            "error": {
              "type": "integer",
              "minimum": 0
            },
            "warn": {
              "type": "integer",
              "minimum": 0
            },
            "info": {
              "type": "integer",
              "minimum": 0
            }
          },
          "required": [
            "error",
            "warn",
            "info"
          ],
          "additionalProperties": false
        },
        "byCategory": {
          "type": "object",
          "properties": {
            "surface": {
              "type": "integer",
              "minimum": 0
            },
            "naming": {
              "type": "integer",
              "minimum": 0
            },
            "descriptions": {
              "type": "integer",
              "minimum": 0
            },
            "schemas": {
              "type": "integer",
              "minimum": 0
            },
            "annotations": {
              "type": "integer",
              "minimum": 0
            },
            "design": {
              "type": "integer",
              "minimum": 0
            }
          },
          "required": [
            "surface",
            "naming",
            "descriptions",
            "schemas",
            "annotations",
            "design"
          ],
          "additionalProperties": false
        }
      },
      "required": [
        "bySeverity",
        "byCategory"
      ],
      "additionalProperties": false
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ruleId": {
            "type": "string"
          },
          "toolName": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "evidence": {
            "type": "string"
          },
          "severity": {
            "type": "string",
            "enum": [
              "error",
              "warn",
              "info"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "surface",
              "naming",
              "descriptions",
              "schemas",
              "annotations",
              "design"
            ]
          },
          "docsUrl": {
            "type": "string"
          }
        },
        "required": [
          "ruleId",
          "message",
          "severity",
          "category",
          "docsUrl"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "staticAnalysis",
    "targetToolsInvoked",
    "grade",
    "server",
    "source",
    "stats",
    "scores",
    "findingCounts",
    "findings"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 1개
검증됨버전이 기록되지 않음도구 1개
검증됨버전이 기록되지 않음도구 1개