validate-mcp

对MCP服务器配置文件（.mcp.json）进行验证。当用户提出“检查我的.mcp.json”“我的MCP为什么无法正常工作”“.mcp.json报错”“验证MCP服务器”或“MCP连接失败”的需求时使用。验证传输类型（stdio、sse、http、websocket）、服务器名称以及环境变量。

SKILL.md

--- frontmatter

name: validate-mcp
description: Validates MCP server configuration files (.mcp.json). Use when user asks to "check my .mcp.json", "why isn't my MCP working", ".mcp.json errors", "validate MCP servers", or "MCP connection failed". Validates transport types (stdio, sse, http, websocket), server names, and environment variables.
version: 1.0.0
argument-hint: "[flags]"
allowed-tools:
  - Bash(claudelint:*)

Validate MCP Servers

Runs claudelint validate-mcp to validate .mcp.json configuration files.

Usage

bash

claudelint validate-mcp $ARGUMENTS

Options

•--path <path> - Custom path to .mcp.json
•--verbose - Show detailed output
•--warnings-as-errors - Treat warnings as errors

What Gets Validated

•JSON syntax
•Server name uniqueness and consistency
•Transport type (stdio, sse)
•Stdio transport (command validation)
•SSE transport (URL validation)
•Variable expansion patterns (${VAR}, ${VAR:-default})
•Environment variables

Examples