dnobj/axisinv

Axis Inventory MCP Server

A standalone Model Context Protocol (MCP) server for managing Axis network device inventory with AI-powered barcode scanning and vision analysis.

Features

🔍 Advanced Image Analysis

• AI vision analysis using Google Gemini 2.0 Flash
• Barcode/QR code scanning with pyzbar + OpenCV
• Cross-validation between vision and barcode data

📦 Complete Inventory Management

• Google Sheets backend integration
• Search, add, update, remove device operations
• Status tracking (CheckedIn/CheckedOut/Retired)

🤖 MCP Protocol Compliance

• Full MCP 1.0 protocol support
• RESTful HTTP API with SSE (Server-Sent Events)
• Tool discovery and invocation

Quick Start

1. Installation

cd /mnt/c/axisinv
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your API keys

2. Run the Server

# Start MCP server (default port 8003)
python -m mcp_server_axis.server

# Health check
curl http://localhost:8003/health

3. Connect from Discord Bot (/mnt/c/heybots)

Update your bot's config.json:

{
  "mcp": {
    "servers": [
      {
        "name": "axis-inventory",
        "transport": "sse",
        "url": "http://localhost:8003",
        "server_name": "axis_inventory"
      }
    ]
  }
}

Architecture

Discord Bot (heybots) ←→ HTTP/SSE ←→ Axis Inventory MCP Server (axisinv)
                                        ├── Google Sheets (inventory)
                                        ├── Google Gemini (vision)  
                                        └── OpenCV/pyzbar (barcodes)

Clean Separation:

• axisinv: Standalone MCP server with all Axis inventory logic
• heybots: Pure Discord bot framework that connects to external servers

The server runs independently and can serve multiple Discord bots or other MCP clients simultaneously.