anomalyarmor/anomalyarmor-mcp-server

AnomalyArmor MCP Server

A Model Context Protocol (MCP) server that provides Claude Code with direct access to your AnomalyArmor intelligence data. Ask natural language questions about schema drift, data quality, freshness, and monitoring insights directly in your development workflow.

Features

• 🧠 Natural Language Queries: Ask questions like "What schema changes happened this week?"
• 🔄 Real-time Intelligence: Access live data from your AnomalyArmor instance
• 🏢 Company-wide Analysis: Query across all your database assets
• 🎯 Asset-specific Focus: Drill down into individual databases
• ⚡ Streaming Responses: Handle long-running LLM queries with progress updates

Quick Start

1. Install & Setup OAuth

npx @anomalyarmor/mcp-server setup

This will:

• 🌐 Open your browser to create an OAuth app
• 🔑 Guide you through getting your credentials
• ⚙️ Show you exactly what to add to Claude Code

2. Add to Claude Code

Copy the configuration from setup into your Claude Code MCP settings:

{
  "mcpServers": {
    "anomalyarmor": {
      "command": "npx",
      "args": ["@anomalyarmor/mcp-server"],
      "env": {
        "ANOMALYARMOR_CLIENT_ID": "your-client-id",
        "ANOMALYARMOR_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

3. Start Asking Questions

Restart Claude Code and ask:

"What schema changes happened this week?"
"Show me data freshness issues"  
"Are there any alerts I should know about?"

Manual Setup (Alternative)

If you prefer manual setup:

1. Create OAuth App: Visit AnomalyArmor OAuth Apps
2. Get Credentials: Copy your Client ID and Client Secret
3. Configure Claude Code: Use the JSON above with your credentials

Usage Examples

Schema Intelligence

"What schema changes happened in the last week?"
"Show me all columns added to the users table this month"
"Are there any inconsistencies between my production and staging schemas?"

Data Quality & Freshness

"Which tables haven't been updated in the last 24 hours?"
"What data quality problems do I have across all my databases?"
"Show me any tables that are missing their freshness SLAs"

Alert & Monitoring

"What alerts fired yesterday and what caused them?"
"Show me all my active monitoring rules for the orders table"
"Are there any recurring alert patterns I should be aware of?"

Business Context

"What business tags are applied to tables containing customer data?"
"Show me all PII-tagged columns and their current protection status"
"Give me a complete health summary of all my data assets"

Configuration Options

Environment Variables

• ANOMALYARMOR_CLIENT_ID (required): Your OAuth application client ID
• ANOMALYARMOR_CLIENT_SECRET (required): Your OAuth application client secret
• ANOMALYARMOR_BASE_URL (optional): API base URL (default: https://app.anomalyarmor.ai)
• LOG_LEVEL (optional): Logging level - debug, info, warn, error (default: info)

Setup Commands

Interactive Setup

npx @anomalyarmor/mcp-server setup

Validate Credentials

npx @anomalyarmor/mcp-server setup --validate

Help

npx @anomalyarmor/mcp-server --help

Alternative Installation Methods

Local development:

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

Architecture

The MCP server acts as a bridge between Claude Code and your AnomalyArmor intelligence data:

Claude Code ←→ MCP Server ←→ AnomalyArmor API ←→ Intelligence Data

1. You ask a question in Claude Code
2. MCP server receives the query and authenticates with your API key
3. AnomalyArmor API processes the question using your intelligence data
4. Streaming response provides real-time progress for long-running LLM queries
5. Claude receives the formatted intelligence response

Troubleshooting

Authentication Issues

Problem: Authentication failed: Invalid OAuth client credentials

Solutions:

• Verify Client ID and Client Secret copied correctly (no extra spaces)
• Check OAuth application is active in AnomalyArmor Settings → OAuth Applications
• Ensure application has required scopes: mcp:read and mcp:intelligence
• Verify ANOMALYARMOR_BASE_URL matches your instance

No Intelligence Data

Problem: No intelligence context found

Solutions:

• Wait 5-10 minutes for initial intelligence generation
• Verify database assets are connected in AnomalyArmor
• Check that intelligence jobs have run (AnomalyArmor → Jobs)

MCP Server Not Found

Problem: MCP server 'anomalyarmor' not found

Solutions:

• Restart Claude Code after configuration changes
• Verify package installed: npm list -g @anomalyarmor/mcp-server
• Check MCP configuration syntax in Claude Code settings
• Ensure environment variables are set correctly

Connection Timeouts

Problem: Queries taking too long or timing out

Solutions:

• Enable debug logging: LOG_LEVEL=debug in environment variables
• Check AnomalyArmor service status
• Verify network connectivity to your AnomalyArmor instance

Development

Setup Development Environment

git clone https://github.com/anomalyarmor/anomalyarmor-mcp-server
cd anomalyarmor-mcp-server
npm install

Run Tests

npm test

Code Formatting

npm run lint

API Requirements

This MCP server requires AnomalyArmor API v1.0+ with OAuth 2.0 support and these endpoints:

• /oauth/token - OAuth 2.0 Client Credentials flow
• /api/v1/auth/me - Token validation and company information
• /api/v1/companies/{id}/intelligence/* - Intelligence data endpoints
• Bearer token authentication with OAuth access tokens
• Company-scoped and asset-scoped queries

Support

• Issues: GitHub Issues
• Documentation: AnomalyArmor Docs
• Support: support@anomalyarmor.ai

License

MIT License - see file for details.