Skip to main content
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

Metadata

Release files for nain-mcp-validator 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nain-mcp-validator 0.1.0
File Size Uploaded Provenance Actions
nain_mcp_validator-0.1.0.tar.gz 14.6 kB With provenance Details for nain_mcp_validator-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nain-mcp-validator 0.1.0
File Interpreter ABI Platform Actions
nain_mcp_validator-0.1.0-py3-none-any.whl Python 3 none any Details for nain_mcp_validator-0.1.0-py3-none-any.whl

Total release size: 24.2 kB

Release files / nain_mcp_validator-0.1.0.tar.gz

Download URL nain_mcp_validator-0.1.0.tar.gz
Size 14.6 kB
Tags Source
SHA-256 checksum
How to use checksums
572a6cf946c186b5c1ad35ad83f4133524cf7021330ca29d3228429dbf6f224d
BLAKE2b-256 checksum
How to use checksums
59b5d7bc4291847e3784616441f0267ac588c863a6db982ca89fe0121b2be7ec
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Release files / nain_mcp_validator-0.1.0-py3-none-any.whl

Download URL nain_mcp_validator-0.1.0-py3-none-any.whl
Size 9.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c22b8b36cc90ff3cc26c23d803210f0f26373683dbf45ff98b32f1b577e0cf2a
BLAKE2b-256 checksum
How to use checksums
300aed53a61e2eb003687a7ca1b3324f69fc0d5596bb35040ac68d359f21e278
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

Security for nain-mcp-validator 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for nain_mcp_validator-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 21, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page