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

Installation

Via NPM (Recommended)

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

• 📧 Email: support@anava.ai
• 💬 Discord: Join our community
• 📚 Docs: docs.anava.ai