hidennsim 1.0.1

Secure MCP server with JAX-based numerical tools

HIDENNSIM - Secure MCP Server with JAX Integration

A licensed Model Context Protocol (MCP) server providing JAX-based numerical computation tools with hardware-bound license validation.

Features

• ✅ MCP server with add_jax tool for floating-point addition using JAX
• ✅ Layered security with Cython binary compilation (source code protected)
• ✅ Hardware-bound license validation system
• ✅ Cross-platform support (Windows, macOS, Linux)
• ✅ Available on PyPI - simple pip install installation
• ✅ Integration guides for Claude Desktop, Cursor, and ChatGPT

Security

HIDENNSIM uses multiple layers of protection:

1. Cython Compilation: Core modules compiled to binary (.pyd/.so) for source code protection
2. License Validation: Hardware-bound licenses tied to machine fingerprint
3. Encrypted Licensing: Secure license file encryption with runtime validation
4. Legal Protection: Proprietary license terms and copyright protection

When installed via PyPI, users receive only compiled binaries - source code for security-sensitive modules is not distributed.

Quick Start

1. Create Virtual Environment (Recommended)

Creating a virtual environment isolates HIDENNSIM and its dependencies from your system Python, preventing conflicts with other projects.

macOS/Linux:

python3 -m venv hidennsim-env
source hidennsim-env/bin/activate

Windows (PowerShell):

python -m venv hidennsim-env
.\hidennsim-env\Scripts\Activate.ps1

Windows (Command Prompt):

python -m venv hidennsim-env
hidennsim-env\Scripts\activate.bat

Note: Your terminal prompt should now show (hidennsim-env) indicating the virtual environment is active.

2. Install HIDENNSIM

Standard Installation (PyPI):

pip install hidennsim

Alternative: Install from Wheel File

If you received a wheel file (.whl) directly:

Windows (PowerShell):

pip install C:\Path\To\hidennsim-1.0.0-cp313-cp313-win_amd64.whl

macOS/Linux:

pip install /path/to/hidennsim-1.0.0-cp313-cp313-win_amd64.whl

Note: For wheel-based installation details, see CLIENT_INSTALLATION.md.

3. Install JAX

Choose the appropriate JAX installation for your system:

CPU-Only:

pip install "jax[cpu]"

GPU-Accelerated (NVIDIA GPU with CUDA):

pip install "jax[cuda12]"

4. Get Hardware Fingerprint

hidennsim-license hardware

Example output:

🖥️  Hardware Fingerprint:
   sha256:a1b2c3d4e5f6...

📝 Provide this fingerprint when purchasing a license.

Important: Copy this fingerprint - you'll need it to obtain your license.

5. Obtain License Key

Contact [e-mail] with:

• Your email address
• Hardware fingerprint from Step 4
• Desired license duration (1 year, 2 years, etc.)

You will receive a license.key file via email.

6. Activate License

Once you receive your license.key file:

hidennsim-license activate /path/to/license.key

Success message:

✅ License activated successfully!

📄 License Information:
   License ID: HNNS-A1B2-C3D4-E5F6-G7H8
   Issued to:  [e-mail]
   Expires:    2026-10-18

7. Configure LLM

Claude Desktop Config Location

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Configuration

Add to your Claude Desktop config:

If virtual environment is active when starting Claude Desktop:

{
  "mcpServers": {
    "hidennsim": {
      "command": "hidennsim",
      "args": [],
      "env": {}
    }
  }
}

OR use full path to virtual environment executable:

macOS/Linux:

{
  "mcpServers": {
    "hidennsim": {
      "command": "/full/path/to/hidennsim-env/bin/hidennsim",
      "args": [],
      "env": {}
    }
  }
}

Windows:

{
  "mcpServers": {
    "hidennsim": {
      "command": "C:\\full\\path\\to\\hidennsim-env\\Scripts\\hidennsim.exe",
      "args": [],
      "env": {}
    }
  }
}

Documentation

User Documentation

• Installation Guide
• Configuration Guide
• License Activation
• Troubleshooting
• Client Installation (Wheel-based)

Developer Documentation

• PyPI Implementation Complete - Implementation summary and quick commands
• Cython Security Analysis - Security architecture and threat model
• License Issue Resolution - License signature validation troubleshooting
• Critical Update Required - IMPORTANT: PyPI package update status

System Requirements

• Python: 3.10 or higher
• Operating System: Windows 10+, macOS 12+, or Linux (Ubuntu 20.04+)
• RAM: 4GB minimum (8GB recommended for GPU acceleration)
• Disk Space: 1GB for installation

License

Proprietary - Contact [e-mail] for licensing information.

Support

• Email: [e-mail]
• Documentation: https://hidennsim.readthedocs.io
• Issues: https://github.com/yourusername/hidennsim/issues