Metadata-Version: 2.4
Name: nain-mcp-validator
Version: 0.1.0
Summary: Deterministic 3D asset validation and content integrity server for the Model Context Protocol (MCP).
Author-email: Aitor Nain Mendoza Vallejo <contact@naindev.com>
License: MIT
Project-URL: Homepage, https://mcp.naindev.com/
Project-URL: Repository, https://github.com/Nain9Dev/nain-mcp-validator
Keywords: mcp,model-context-protocol,3d,mesh-validation,gltf,deterministic
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: mypy>=1.10.0; extra == "dev"
Requires-Dist: ruff>=0.4.0; extra == "dev"
Dynamic: license-file

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.svg">
  <source media="(prefers-color-scheme: light)" srcset="docs/assets/banner-light.svg">
  <img alt="nain-mcp-validator Architectural Blueprint" src="docs/assets/banner-dark.svg" width="100%">
</picture>

# 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](https://img.shields.io/badge/Language-English-blue.svg)](#)
[![Versión en Español](https://img.shields.io/badge/Versión-Español-red.svg)](README.es.md)
[![Protocol](https://img.shields.io/badge/MCP-2024--11--05-0047AB)](https://modelcontextprotocol.io/)
[![Python](https://img.shields.io/badge/Python-3.11+-3776AB)](https://www.python.org/)
[![Validation](https://img.shields.io/badge/Checks-C1_to_C10-22c55e)](docs/01-requirements.md)
[![License](https://img.shields.io/badge/License-MIT-gray)](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:

```bash
uvx nain-mcp-validator
```

Until then, run it straight from the repository:

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

MCP client configuration:

```json
{
  "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

```bash
# Run pytest verification suite
pytest -v
```

## 3. Integration with AI Clients

Add the server to your Claude Desktop or Cursor configuration:

```json
{
  "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](https://github.com/Nain9Dev/engineering-handbook)
