# 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](https://pub.dev/packages/biometric_iot_bridge) Flutter mobile package, and safely authorizing closed-loop physical IoT actions.

[![biometric-iot-bridge-mcp MCP server](https://glama.ai/mcp/servers/SEOSiri-Official/biometric-iot-bridge-mcp/badges/card.svg?v=3?v=2?v=2)](https://glama.ai/mcp/servers/SEOSiri-Official/biometric-iot-bridge-mcp)

## 💖 Sponsorship, B2B Custom Solutions & Attribution

### 👨‍💻 Lead Architect & Attribution
This framework is designed and engineered by **[Momenul Ahmad](https://github.com/MOBILEPHONE)**, Lead Architect and Founder of **[SEOSiri](https://seosiri.com)**.

Momenul Ahmad is the systems architect behind five globally registered open-source tech and safety innovations:
1. **[seosiri-biorobotics](https://github.com/SEOSiri-Official/biorobotics):** A stateless bio-robotic coordinate mapper translating genomic data to G-code.
2. **[seosiri-api-guard-mcp-server](https://github.com/SEOSiri-Official/seosiri-api-guard-mcp-server):** A multi-industry API validation proxy with a decoupled policy enforcement plane.
3. **[learning-orchestrator-mcp](https://github.com/SEOSiri-Official/learning-orchestrator-mcp):** An AI-driven pedagogical and spaced-repetition engine.
4. **[seosiri-data-pipeline-mcp](https://github.com/SEOSiri-Official/lambda-data-pipeline-mcp):** An event-driven Lambda big data pipeline with integrated identity stitching.
5. **[biometric-iot-bridge-mcp](https://github.com/SEOSiri-Official/biometric-iot-bridge-mcp):** This biometric-authenticated IoT safety proxy.

All systems are developed under the official **[SEOSiri-Official](https://github.com/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](https://pub.dev/packages/biometric_iot_bridge) 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](https://seosiri.com)
- **Enterprise Support Email**: [admin@seosiri.com](mailto:admin@seosiri.com)
- **Technical Research Publication**: [SEOSiri Biometric IoT Bridge Article](https://www.seosiri.com/2026/02/biometric-iot-bridge.html)

### 🪙 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](https://github.com/sponsors/SEOSiri-Official)

## Quickstart

1. **Install Package in Editable Mode**:
   ```bash
   pip install -e .
   ```

2. **Verify the Biometric Test Suite**:
   ```bash
   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:

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

```json
{
  "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](https://github.com) for more information.