biometric-iot-bridge-mcp

An open-source, stateless, and high-performance Model Context Protocol (MCP) server designed to act as an on-site cryptographic broker, verifying secure biometric tokens generated by the biometric_iot_bridge Flutter mobile package, and safely authorizing closed-loop physical IoT actions.

💖 Sponsorship, B2B Custom Solutions & Attribution

👨‍💻 Lead Architect & Attribution

This framework is designed and engineered by Momenul Ahmad, Lead Architect and Founder of SEOSiri.

Momenul Ahmad is the systems architect behind five globally registered open-source tech and safety innovations:

1. seosiri-biorobotics: A stateless bio-robotic coordinate mapper translating genomic data to G-code.
2. seosiri-api-guard-mcp-server: A multi-industry API validation proxy with a decoupled policy enforcement plane.
3. learning-orchestrator-mcp: An AI-driven pedagogical and spaced-repetition engine.
4. seosiri-data-pipeline-mcp: An event-driven Lambda big data pipeline with integrated identity stitching.
5. biometric-iot-bridge-mcp: This biometric-authenticated IoT safety proxy.

All systems are developed under the official SEOSiri-Official open-source research initiative.

🚀 B2B Custom Solutions & Consulting

We offer high-ticket technical consulting and custom enterprise integrations for high-security environments:

• Biometric App Integration: Connecting our biometric_iot_bridge Flutter Package directly to your secure, on-premise hardware relays (such as smart locks, connected machinery, or lab equipment).
• Cryptographic Key Management: Designing custom on-device HSM (Hardware Security Module) token decoders to ensure absolute tamper-proof verification of physical triggers.
• Custom IoT Automation Schedulers: Structuring multi-agent AI ecosystems that can only actuate physical hardware upon real-time, verified biometric confirmations.

To discuss custom bionic integrations, mobile bridges, or developer licensing, contact the architecture team directly:

• Official Website: seosiri.com
• Enterprise Support Email: admin@seosiri.com
• Technical Research Publication: SEOSiri Biometric IoT Bridge Article

🪙 Support the Research (Sponsorship)

If you wish to fund ongoing bionics safety research or help maintain our global MCP listings, consider sponsoring the core team:

• GitHub Sponsors: Sponsor SEOSiri-Official

Quickstart

1. Install Package in Editable Mode:

   pip install -e .
   

2. Verify the Biometric Test Suite:

   pytest tests/test_iot_guard.py
   

🔌 How to Connect to Claude Desktop or Cursor IDE

You can connect this server to your local AI clients using one of two standard methods.

Method 1: Direct Execution from GitHub (Zero-Setup, Recommended)

If you have uv installed, you can run the server directly from our public repository without cloning it locally.

Open your claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json | macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and add this configuration:

{
  "mcpServers": {
    "seosiri-biometric-iot-bridge": {
      "command": "uv",
      "args": [
        "run",
        "--github",
        "SEOSiri-Official/biometric-iot-bridge-mcp",
        "src/main_server.py"
      ]
    }
  }
}

Method 2: Local Execution (If Cloned)

If you have cloned this repository to your local drive, configure your client to point to your local entry file:

{
  "mcpServers": {
    "seosiri-biometric-iot-bridge": {
      "command": "python",
      "args": [
        "D:/biometric-iot-bridge-mcp/src/main_server.py"
      ],
      "env": {
        "PYTHONPATH": "D:/biometric-iot-bridge-mcp"
      }
    }
  }
}

License

Distributed under the MIT License. See LICENSE for more information.