Repository avatar
AI Tools
v0.1.0
active

nain-mcp-validator

io.github.Nain9Dev/nain-mcp-validator

Deterministic 3D mesh validation (C1-C10) and SHA-256 checks for AI agents.

Documentation

nain-mcp-validator Architectural Blueprint

nain-mcp-validator

Standalone Model Context Protocol (MCP) server providing deterministic 3D asset validation (checks C1-C10), content-addressed artifact verification (SHA-256), and fail-closed conformance reporting for AI engineering agents.

Language: English Versión en Español Protocol Python Validation License

mcp-name: io.github.Nain9Dev/nain-mcp-validator


Install and run

The server speaks JSON-RPC over stdio and has no network access. Once the package is on PyPI:

uvx nain-mcp-validator

Until then, run it straight from the repository:

uvx --from git+https://github.com/Nain9Dev/nain-mcp-validator nain-mcp-validator

MCP client configuration:

{
  "mcpServers": {
    "nain-mcp-validator": {
      "command": "uvx",
      "args": ["nain-mcp-validator"]
    }
  }
}

1. Overview

nain-mcp-validator solves the reliability gap when AI agents generate CAD geometry, meshes, or engineering specifications. Instead of relying on probabilistic text inspection, it equips agents with deterministic validation tools:

  • validate_mesh_invariants: Topological validation enforcing watertight closure, 2-manifold boundaries, outward normal consistency, and the quantum sliver threshold ($10^{-12}\text{ m}^2$).
  • verify_content_digest: Cryptographic verification of SHA-256 content hashes.
  • generate_conformance_report: Produces standardized markdown conformance audits with a fail-closed verdict.

2. Quickstart & Testing

# Run pytest verification suite
pytest -v

3. Integration with AI Clients

Add the server to your Claude Desktop or Cursor configuration:

{
  "mcpServers": {
    "nain-validator": {
      "command": "python",
      "args": ["-m", "nain_mcp_validator.server"],
      "cwd": "/path/to/nain-mcp-validator"
    }
  }
}

Author: Aitor Nain Mendoza Vallejo
Standards: NainDev Engineering Handbook

PYPI
nain-mcp-validator
Install Command
pip install nain-mcp-validator