Skip to main content
Glama
Anava MCP Server

Anava MCP Server

by AnavaAcap

Anava MCP Server

MCP (Model Context Protocol) server for Anava AI-powered security cameras. This server enables AI assistants like Claude to interact with Anava-enabled Axis cameras for real-time image analysis and event monitoring.

Overview

The Anava MCP Server acts as a bridge between AI assistants and Anava ACAP applications running on Axis cameras. It provides a standardized interface for:

  • 📸 Capturing and analyzing images with custom prompts

  • 📊 Retrieving historical events and analytics

  • 🔍 Real-time camera monitoring

  • ⚙️ Camera configuration management

Related MCP server: MCP Unified Server

Installation

npm install -g @anava/mcp-server

Via Docker

docker pull anava/mcp-server
docker run -e ANAVA_HOST=your-camera-ip -e ANAVA_USERNAME=root -e ANAVA_PASSWORD=pass anava/mcp-server

From Source

git clone https://github.com/AnavaAI/anava-mcp-server.git
cd anava-mcp-server
npm install
npm run build

Configuration

Claude Desktop Setup

Add the MCP server to your Claude Desktop configuration:

  1. Open Claude Desktop settings

  2. Navigate to MCP Servers

  3. Add the following configuration:

{
  "mcpServers": {
    "anava-vision": {
      "command": "npx",
      "args": ["@anava/mcp-server"],
      "env": {
        "ANAVA_HOST": "192.168.1.100",
        "ANAVA_PORT": "80",
        "ANAVA_USERNAME": "root",
        "ANAVA_PASSWORD": "your-password"
      }
    }
  }
}

Environment Variables

Variable

Description

Default

ANAVA_HOST

IP address of your Axis camera

Required

ANAVA_PORT

HTTP port of the camera

80

ANAVA_USERNAME

Camera username

root

ANAVA_PASSWORD

Camera password

Required

Usage

Once configured, you can use the following commands in Claude:

Capture and Analyze

@anava-vision capture-and-analyze "What do you see in this image?"

Get Recent Events

@anava-vision get-events --limit 10

Get Event by ID

@anava-vision get-event <event-id>

Get Event History

@anava-vision get-event-history --days 7

Development

Prerequisites

  • Node.js 18+

  • TypeScript 5+

  • An Axis camera with Anava ACAP installed

Building

npm install
npm run build

Testing

npm test
npm run test:integration  # Requires camera connection

Running Locally

# Development mode with hot reload
npm run dev

# Production mode
npm start

API Reference

MCP Tools

capture-and-analyze

Captures an image from the camera and analyzes it with a custom prompt.

Parameters:

  • prompt (string, required): The analysis prompt

  • channel (number, optional): Camera channel (default: 1)

  • securityProfile (string, optional): Security profile ID to use

Returns:

  • analysis: AI analysis results

  • imageData: Base64 encoded image

  • metadata: Timestamp and camera info

get-events

Retrieves recent events from the camera.

Parameters:

  • limit (number, optional): Number of events to retrieve (default: 50)

Returns:

  • Array of event objects

get-event

Retrieves a specific event by ID.

Parameters:

  • eventId (string, required): Event ID

Returns:

  • Event object with full details

get-event-history

Gets event statistics over a time period.

Parameters:

  • days (number, optional): Number of days to look back (default: 7)

Returns:

  • Event counts by type and date

Troubleshooting

Authentication Failed

  • Verify camera credentials are correct

  • Ensure the camera is accessible from your network

  • Check if digest authentication is enabled on the camera

No Response from Camera

  • Verify the Anava ACAP is installed and running

  • Check camera IP and port settings

  • Ensure firewall allows connection to camera

Analysis Returns Empty

  • Verify Vertex AI credentials are configured in the ACAP

  • Check if the security profile has valid API keys

  • Ensure the camera has internet access for AI services

Security Considerations

  • Store camera credentials securely

  • Use HTTPS when possible (requires camera certificate)

  • Limit network access to cameras

  • Regularly update camera firmware and ACAP

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

MIT License - see LICENSE for details.

Support

Available Tools

4 tools
anava_capture_analyzeC

Capture an image from camera and analyze it with AI

Inputs: prompt (required), camera, channel, security_profile.

anava_capture_imageB

Capture an image from camera without analysis

Inputs: camera, channel, resolution.

anava_get_eventsC

Get historical events from camera

Inputs: camera, end_time, limit, start_time.

anava_monitor_eventsC

Monitor camera for real-time events

Inputs: camera, duration, event_types.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: capture+analyze, capture-only, get historical events, and monitor real-time events. The descriptions make it impossible to confuse which tool to use for each specific camera/AI task.

    Naming Consistency5/5

    All tools follow a perfect 'anava_verb_noun' pattern with consistent snake_case throughout. The naming is predictable and follows the same prefix+action+object structure across all four tools.

    Tool Count5/5

    Four tools is ideal for this camera/AI monitoring server scope - it covers the essential operations (capture, analyze, historical data, real-time monitoring) without being too sparse or bloated. Each tool clearly earns its place.

    Completeness5/5

    The tool surface provides complete coverage for camera/AI monitoring: capture functionality (with and without analysis), historical data retrieval, and real-time monitoring. There are no obvious gaps in the core workflow for this domain.

    Related MCP Connectors

    Related MCP Servers