Liongard

Liongard MCP サーバー

Liongard プラットフォームと連携するための MCP（Model Context Protocol）サーバーです。Liongard の API を通じて、インスペクター、システム、メトリクス、アラート、ユーザーなどを管理するツールを AI アシスタントに提供します。

ワンクリックデプロイ

重要

**クリックする前に：**このサーバーは、GitHub Packages の npm レジストリでホストされている @wyre-technology/node-liongard に依存しています。GitHub Packages は匿名アクセスを許可していないため、パッケージが公開されていても、すべての npm install でトークンが必要です。クラウドビルダーが npm install を実行するため、トークンを渡す必要があります。渡さないと、ビルドは npm error 401 Unauthorized ... npm.pkg.github.com で失敗します。

1. read:packages スコープを持つ GitHub Personal Access Token を作成します（classic token）。 公開パッケージを読み取るために wyre-technology org のメンバーである必要はなく、どの GitHub アカウントでも使用できます。
2. デプロイの手順で求められたら、ビルド変数としてトークンを追加します。
   • Cloudflare Workers → NODE_AUTH_TOKEN という名前のビルド変数に PAT を設定します（Workers → Settings → Build → Variables and Secrets）。
   • DigitalOcean App Platform → Build Time スコープで、GITHUB_TOKEN という名前の暗号化環境変数に PAT を設定します（Dockerfile がインストール時に読み取ります）。

特長

• 意思決定ツリー型のツールアーキテクチャ — ナビゲーションツールから始まり、必要に応じてドメイン固有のツールを公開します
• インスペクター、システム、メトリクス、アラート、ユーザー、グループ、環境、インテグレーションにわたる 25 個のツール
• MCP Apps（SEP-1865）によるインタラクティブな検出カード：liongard_detections_get は、MCP Apps ホスト（Claude Desktop/web）で読み取り専用カードとして表示され、重要度／ステータスバッジと、サーバーが解決したシステム名／環境名を表示します。デフォルトはニュートラルなデザインで、window.__BRAND__ の挿入または MCP_BRAND_* 環境変数（MCP_BRAND_NAME、MCP_BRAND_LOGO_URL、MCP_BRAND_PRIMARY_COLOR、MCP_BRAND_ACCENT_COLOR、MCP_BRAND_BG、MCP_BRAND_TEXT）でブランド化できます。再ビルドは不要です
• v1 と v2 の両方の API バージョンに対応
• 128 件のテスト

インストール

このプロジェクトは、GitHub Packages の npm レジストリに公開されている @wyre-technology/node-liongard に依存しています。公開パッケージでもトークンが必要です。認証を一度行ってから、インストールしてください。

# Authenticate npm to GitHub Packages (token needs the read:packages scope)
export NODE_AUTH_TOKEN=$(gh auth token)   # or a PAT with read:packages

npm install

リポジトリの .npmrc では、すでに @wyre-technology スコープが GitHub Packages を参照し、トークンを NODE_AUTH_TOKEN から読み取るよう設定されているため、追加の設定は不要です。

設定

.env.example をコピーします。Stdio と AUTH_MODE=env は Liongard の変数を読み取ります。Gateway モードでは読み取りません。

変数	必須	説明
LIONGARD_API_KEY	Stdio および AUTH_MODE=env の場合	Liongard API キー
LIONGARD_INSTANCE	Stdio および AUTH_MODE=env の場合	Liongard インスタンスのホスト名（例：yourorg.app.liongard.com）
MCP_TRANSPORT	いいえ	stdio（デフォルト）または http
AUTH_MODE	いいえ	env（デフォルト）または gateway。Gateway モードでは、各 /mcp リクエストに X-Liongard-API-Key と X-Liongard-Instance が必要です。また、LIONGARD_* にフォールバックすることはありません。
CONDUIT_S2S_SECRET	HTTP の場合は必須	サービス間シークレット。この値が空、または既知のプレースホルダーの場合、HTTP サーバーはエラーをログに記録し、ゼロ以外の終了コードで終了します。設定されていない場合、Compose は起動しません。実際の値をコミットしないでください。openssl rand -hex 32 で生成できます。
MCP_ALLOW_INSECURE_DEV	いいえ	CONDUIT_S2S_SECRET なしで HTTP を起動する場合に限り、ローカル開発用に 1 を設定します。プロセスは警告をログに記録し、X-Gateway-S2S を強制せず、127.0.0.1 のみをバインドします。ループバック以外の MCP_HTTP_HOST が指定されている場合、起動を拒否します。既知のプレースホルダーシークレットも引き続き拒否されます。
MCP_HTTP_HOST	いいえ	実際の CONDUIT_S2S_SECRET が設定されている場合のバインドアドレス。未設定の場合は 0.0.0.0 が維持されます。これはコンテナイメージで設定されている値で、コンテナのデプロイ時にはコンテナ内のすべてのインターフェースで待ち受けます。シークレットがない場合、開発用のバイパスでは代わりに 127.0.0.1 をバインドします。
MCP_HTTP_PORT	いいえ	HTTP ポート。デフォルトは 8080 です。

/health は認証なしで利用でき、認証情報を読み取りません。Stdio トランスポートでは CONDUIT_S2S_SECRET を使用しません。

HTTP 認証

MCP_TRANSPORT=http で CONDUIT_S2S_SECRET が設定されている場合、すべての /mcp リクエストに X-Gateway-S2S を含める必要があります。値は t=<unix seconds>,v1=<hex> です。v1 は、CONDUIT_S2S_SECRET をキーとして、正確な文字列 t=<unix seconds> に対して計算した HMAC-SHA256（小文字の 16 進数 64 文字）です。タイムスタンプはサーバーの時計との差が 300 秒以内でなければなりません。ヘッダーがない場合、または無効な場合は 401 を返します。シークレットがログに書き込まれることはありません。

import { createHmac } from "node:crypto";

const t = Math.floor(Date.now() / 1000);
const v1 = createHmac("sha256", process.env.CONDUIT_S2S_SECRET)
  .update(`t=${t}`)
  .digest("hex");
const xGatewayS2s = `t=${t},v1=${v1}`;

AUTH_MODE=gateway の場合、/mcp では X-Liongard-API-Key と X-Liongard-Instance も必要です。そのリクエストでは、これらのヘッダーのみが認証情報の取得元となります。どちらかのヘッダーが欠けているリクエストには 401 を返し、環境変数から LIONGARD_API_KEY または LIONGARD_INSTANCE を読み取りません。

Docker Compose

リポジトリに含まれる Compose サービスは Gateway モードです。127.0.0.1:8080:8080 を公開し、CONDUIT_S2S_SECRET を必須とします。また、LIONGARD_API_KEY、LIONGARD_INSTANCE、env_file は設定しません。

CONDUIT_S2S_SECRET=your-s2s-secret docker compose up --build

使い方

npm start

HTTP は、CONDUIT_S2S_SECRET が実際のシークレットになるまで起動を拒否します。

MCP_TRANSPORT=http CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" npm start

シークレットなしでのローカル HTTP は開発専用です。127.0.0.1 をバインドし、警告をログに記録します。

MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm start

開発

npm run build       # Build the project
npm run test        # Run tests
npm run lint        # Run linter
npm run typecheck   # Type-check

ライセンス

Apache-2.0