Anomalyarmor

armor-mcp

AnomalyArmor MCP サーバーを使用すると、AI アシスタント（Claude Code、Cursor、Claude Desktop、あらゆる MCP クライアント）が、50 以上の構造化されたツールを通じてデータウェアハウスを操作できます。アラートの確認、鮮度の監視、スキーマドリフトの調査、妥当性ルールの設定、自然言語によるリネージの追跡が可能です。

• ホームページ：https://www.anomalyarmor.ai
• ドキュメント：https://docs.anomalyarmor.ai/integrations/mcp-server
• サーバーカード：https://www.anomalyarmor.ai/.well-known/mcp/server-card.json
• ステータス：本番運用中。バージョン管理された MCP プロトコル 2025-06-18。OAuth 2.1 + API キー認証。

接続方法は 2 種類

方法	認証	最適な用途
リモート（推奨）	OAuth 2.1（Clerk）	インストール不要、常に最新
ローカル	API キー	エアギャップ環境、オンコール用ノート PC、カスタムプロキシ

リモート（推奨）

サーバーは https://mcp.anomalyarmor.ai/mcp（Streamable HTTP トランスポート）でホストされています。最初の呼び出し時に OAuth 用のブラウザーが開き、トークンは約 12 時間キャッシュされます。

Claude Code

claude mcp add anomalyarmor --transport http https://mcp.anomalyarmor.ai/mcp

Cursor

~/Library/Application Support/Cursor/mcp.json（macOS）、~/.config/Cursor/mcp.json（Linux）、または %APPDATA%\Cursor\mcp.json（Windows）に追加します。

{
  "mcpServers": {
    "anomalyarmor": {
      "url": "https://mcp.anomalyarmor.ai/mcp"
    }
  }
}

あらゆる MCP クライアント

URL: https://mcp.anomalyarmor.ai/mcp
Transport: streamable-http
Auth: OAuth 2.1
Discovery: https://mcp.anomalyarmor.ai/.well-known/oauth-protected-resource

ローカル（API キー）

リモートサーバーに接続できない場合、またはサードパーティへの依存を避けたい場合に使用します。

インストール

# Recommended: uvx (no install)
uvx armor-mcp

# Or pip
pip install armor-mcp

設定

https://app.anomalyarmor.ai の Settings → API Keys から API キーを取得します。

export ARMOR_API_KEY=aa_live_your_key_here

または、~/.armor/config.yaml に保存します。

api_key: aa_live_your_key_here

クライアントへの接続

{
  "mcpServers": {
    "anomalyarmor": {
      "command": "uvx",
      "args": ["armor-mcp"],
      "env": {
        "ARMOR_API_KEY": "aa_live_your_key_here"
      }
    }
  }
}

ツール

8 つのカテゴリにわたる 53 個のツールがあります。すべてのツールには MCP ToolAnnotations（readOnlyHint、destructiveHint、idempotentHint、openWorldHint: false）が付属しており、ホスト側で自動確認を行うタイミングを判断できます。

ヘルスとブリーフィング

ツール	説明
health_summary	ウェアハウス全体の健全性：古いアセット、ドリフト、アラート
get_todays_briefing	重要なインサイトをまとめた日次ダイジェスト
get_coverage	監視カバレッジ分析
manage_coverage	カバレッジ目標を更新
recommend	AI が提案する次の監視アクション

アラートとインシデント

ツール	説明
list_alerts	フィルター（重大度、日付、ステータス）を指定してアラートを検索
list_inbox_alerts	まだトリアージされていないアラート
get_alerts_summary	集計件数と傾向
get_alert_trends	期間ごとの傾向分析
get_alert_history	アラートのアクティビティタイムライン
update_alert	確認／解決／却下／スヌーズ
list_alert_rules	設定済みルールを表示
create_alert_rule	新しいアラートルールを追加
manage_alert_rule	ルールを更新／削除／プレビュー
manage_rule_destinations	ルールを通知先に接続

アセット

ツール	説明
list_assets	フィルターを指定してデータソースを一覧表示
create_asset	新しいソースを接続
manage_asset	接続を更新／削除／テスト
trigger_asset_discovery	スキーマ検出を開始（非同期）

鮮度

ツール	説明
get_freshness_summary	鮮度の概要
check_freshness	特定のアセット／テーブルを確認
setup_freshness	鮮度スケジュールを一括作成
list_freshness_schedules	設定済みスケジュールを表示
manage_freshness_schedule	スケジュールを更新／削除

スキーマの監視

ツール	説明
get_schema_summary	ドリフトの概要
list_schema_changes	重大度を含む最近の変更
create_schema_baseline	現在のスキーマをベースラインとして取得
enable_schema_monitoring	ドリフト検出を開始
disable_schema_monitoring	ドリフト検出を停止

データ品質（メトリクスと妥当性）

ツール	説明
get_metrics_summary	アセットごとのメトリクスの状態
list_metrics	設定済みメトリクスの一覧
create_metric	メトリクスを追加（行数、NULL の割合など）
manage_metric	メトリクスを更新／削除／取得
get_validity_summary	妥当性ルールの合格／不合格率
list_validity_rules	妥当性ルールの一覧
create_validity_rule	NOT_NULL／UNIQUE／RANGE／REGEX ルールを追加
manage_validity_rule	ルールを更新／削除／実行
create_referential_check	テーブル間の参照整合性チェック
manage_referential	参照整合性チェックを更新／削除

宛先とルーティング

ツール	説明
list_destinations	Slack／メール／Webhook／PagerDuty の設定
setup_destination	新しい宛先を追加
manage_destination	更新／削除／テスト

インテリジェンス、リネージ、タグ、ジョブ

ツール	説明
ask_question	データに関する自然言語での同期的な質疑応答
generate_intelligence	AI 分析を実行（非同期、高コスト）
get_lineage	上流／下流の依存関係グラフ
list_tags	アセットのタグ
create_tag	テーブルまたは列にタグを付ける
apply_tags	タグを一括適用
job_status	非同期ジョブの状態を確認
cancel_job	実行中の非同期ジョブをキャンセル
get_api_key_info	現在の API キーのスコープを確認

詳細な説明、パラメータのスキーマ、プロンプトの例：https://docs.anomalyarmor.ai/integrations/mcp-server。

ツールの安全性に関する規則

ホストは次のアノテーションを尊重します。

カテゴリ	パターン	確認
読み取り専用	list_*、get_*、check_*、search_*	自動実行
変更を伴う操作	create_*、update_*、enable_*、disable_*、manage_*	ユーザーに確認
破壊的操作	delete_*（manage_* 経由）、dismiss_alert	必ず確認し、影響を受けるエンティティを一覧表示
高コスト	generate_intelligence、trigger_asset_discovery	確認が必要。課金対象のジョブがキューに登録されます

マルチテナンシー

OAuth トークン（または API キー）はユーザーの会社にスコープ設定されています。別のテナントになりすますことはできません。company_id 引数を捏造しないでください。

非同期ジョブ

trigger_asset_discovery、generate_intelligence、およびメトリクスの取得は job_id を返します。再実行するのではなく、job_status(job_id) で状態を確認してください。

検出用エンドポイント

ファイル	用途
https://mcp.anomalyarmor.ai/.well-known/oauth-protected-resource	RFC 9728 保護リソースのメタデータ
https://www.anomalyarmor.ai/.well-known/mcp/server-card.json	SEP-1649 MCP サーバーカード
https://www.anomalyarmor.ai/.well-known/agent-card.json	A2A v0.2 エージェントカード
https://www.anomalyarmor.ai/.well-known/api-catalog	RFC 9727 API カタログのリンクセット

開発

git clone https://github.com/anomalyarmor/agents.git
cd agents/armor-mcp
uv sync
uv run pytest

ライセンス

MIT — LICENSE を参照してください。