API Schema Enforcement System + MCP Tool

Build-time validation across NestJS, FastAPI, Flask, Django, Go, and Spring Boot. Enforces API documentation standards so Claude can generate production-ready code.

Quick Start (Local Development)

npm install
npm run validate:all        # Run all validators
npm run mcp:start           # Start MCP server
npm test                    # Run tests

Running as an npm Package (CLI usage)

If published or installed as a dependency:

# 1. Initialize configuration in your project
npx api-schema-enforcement init

# 2. Run all configured validators
npx api-schema-enforcement validate

# 3. Start the MCP server for Cursor or Claude Desktop
npx api-schema-enforcement mcp

Validators

| Framework | File | What it checks | |-----------|------|----------------| | NestJS | validators/nestjs/validate-api-schema.ts | @ApiResponse, @Param, @Body decorators | | FastAPI | validators/fastapi/validate_fastapi.py | Return type hints, Pydantic models, response_model | | Flask | validators/flask/validate_flask.py | @api.route, @api.doc, @api.marshal_with | | Django | validators/django/validate_django.py | serializer_class, @extend_schema | | Go | validators/go/validate_gin.go | Swag comments, struct json/binding tags | | Spring Boot | validators/java/SpringBootSchemaValidator.java | @Schema, @ApiResponse, @RequestBody | | Universal | validators/universal/openapi-validator.ts | Cross-framework OpenAPI spec completeness |

MCP Server

Provides Claude with 5 tools:

• list_endpoints — All available endpoints
• get_endpoint_schema — Detailed schema for one endpoint
• search_endpoints — Find endpoints by keyword
• get_types_schema — All DTOs as TypeScript interfaces
• validate_schema_completeness — Check for missing docs

Individual Validators

npm run validate:nestjs     # NestJS only
npm run validate:fastapi    # FastAPI only
npm run validate:flask      # Flask only
npm run validate:django     # Django only
npm run validate:go         # Go only
npm run validate:spring     # Spring Boot only
npm run validate:universal  # Universal OpenAPI check

CI/CD

GitHub Actions workflow at .github/workflows/validate.yml runs all validators on every push and pull request. Build fails if any endpoint is undocumented.

Requirements

• Node.js 18+
• Python 3.11+
• Go 1.21+
• Java 17+

Multi-framework-API-schema-validation-MCP-tool