mcp-config-validator
v1.0.1
Published
Free CLI tool to validate MCP server configurations. Checks protocol compliance, schema validity, and production readiness.
Maintainers
Readme
MCP Server Validator
Validate your MCP server configurations in seconds. Catch protocol compliance issues, schema errors, and production readiness gaps before deploying.
Try the Web Version | MCP Linter Pro ($9)
Install
npm install -g mcp-validatorUsage
# Validate a config file
mcp-validate ./server.json
# Validate from stdin (pipe-friendly)
cat server.json | mcp-validate -
# Validate a remote server config
mcp-validate --url https://your-server.com/config
# Show all options
mcp-validate --helpWhat It Checks
Protocol Compliance
- Server name and version fields
- Transport type validation (stdio, SSE, Streamable HTTP)
- JSON-RPC 2.0 message format
- Protocol version compliance
Tool Validation
- Tool definitions and naming
- Input schema structure (JSON Schema)
- Required vs optional parameters
- Description quality for AI agent discoverability
Production Readiness
- Prompts and resources declarations
- Error handling patterns
- Security best practices
- Documentation completeness
Example Output
✓ PASS Server name (Name: weather-server)
✓ PASS Version (Version: 1.0.0)
✓ PASS Transport type (Type: stdio)
✓ PASS Tools array (2 tool(s) defined)
✓ PASS get_weather description
✓ PASS get_weather inputSchema
Summary: 6 passed, 0 warnings, 0 errors
Configuration looks good!CI/CD Integration
Add to your GitHub Actions workflow:
- name: Validate MCP Server
run: |
npm install -g mcp-validator
mcp-validate ./server-config.jsonWhy Use This?
MCP is the standard for connecting AI agents to tools. A broken configuration means your server won't work with Claude Desktop, Cursor, or any MCP client. This validator catches issues before your users do.
Free tier (this tool): Config-level validation Pro tier ($9): Runtime testing with actual tool calls, custom rules, team features
Get MCP Linter Pro — Use code GITHUB50 for 50% off
Web Version
Prefer a browser? Try the interactive web validator — paste your config and get instant results with no install required.
Related
- MCP Linter Pro — Runtime validation and custom rules
- AI Growth Ops Framework — Complete B2B agency blueprint
- ShadowCraft Storefront — All developer tools
License
MIT
Built by ShadowCraft AI
