@argosvix/mcp-server 0.2.0-alpha.1 → 0.3.1-alpha.1

package/dist/index.js

@@ -5,65 +5,85 @@
  * AI agent (= Claude Desktop / Cursor / Codex CLI 等) から Argosvix の
  * traces / cost / alert を 直接 query するための Model Context Protocol server。
  *
- * Phase 1 (= 2026-05 v1.5 backlog 着手):
- * - stdio transport のみ (= MCP standard、 Claude Desktop / Cursor 標準)
- * - read-only tools (= query_calls / get_cost_summary / list_alerts)
- * - auth = ARGOSVIX_API_KEY env var 経由
- *
+ * Phase 1 (= 2026-05): stdio transport + read-only tools 3 件
  * Phase 2 (= 完了): 書き込み tools (= silence_alert / unsilence_alert)
- * Phase 3 (= 完了): 書き込み tool create_alert (= 新規 alert ルール作成)
+ * Phase 3 (= 完了): create_alert + read tools 2 件 (get_alert / list_alert_events)
+ *                   + HTTP transport (= 本ファイル + http.ts、 2026-05-31)
  *
- * 後続 phase:
- * - acknowledge_alert
- * - HTTP transport (= remote MCP server 構成)
- * - prompts + resources (= traces / dashboards を 第一級 MCP entity に)
+ * 起動モード:
+ *   - stdio (= default):  argosvix-mcp
+ *       Claude Desktop / Cursor / Codex CLI が subprocess として spawn する想定。
+ *       ARGOSVIX_API_KEY env var が必須。
+ *   - HTTP transport:     argosvix-mcp --http
+ *       remote MCP server として port (default 3000) で listen。 認証は各 request の
+ *       Authorization: Bearer header から。 multi-tenant 用途、 self-host 用。
+ *       env: MCP_HTTP_PORT / MCP_HTTP_HOST / MCP_HTTP_ALLOWED_HOSTS。
  *
- * Install + use (= Claude Desktop の場合):
+ * stdio install + use (= Claude Desktop の場合):
  *   1. npm install -g @argosvix/mcp-server
- *   2. Claude Desktop の `~/Library/Application Support/Claude/claude_desktop_config.json`
+ *   2. Claude Desktop config (= `~/Library/Application Support/Claude/claude_desktop_config.json`)
  *      に 以下を追記:
  *      {
  *        "mcpServers": {
  *          "argosvix": {
  *            "command": "argosvix-mcp",
- *            "env": { "ARGOSVIX_API_KEY": "argosvix_live_..." }
+ *            "env": { "ARGOSVIX_API_KEY": "argk_..." }
  *          }
  *        }
  *      }
  *   3. Claude Desktop 再起動 → tools として 自動認識される
+ *
+ * HTTP install + use:
+ *   1. npm install -g @argosvix/mcp-server (= 同パッケージ)
+ *   2. argosvix-mcp --http  # localhost:3000/mcp で listen
+ *   3. client は POST /mcp に Authorization: Bearer <key> + JSON-RPC body
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { tools, dispatchTool } from "./tools.js";
-const API_KEY = process.env["ARGOSVIX_API_KEY"];
-const API_BASE = process.env["ARGOSVIX_API_BASE"] ?? "https://ingest.argosvix.com";
-if (!API_KEY) {
-    console.error("[argosvix-mcp] ARGOSVIX_API_KEY env var is required. " +
-        "Get a key at https://dashboard.argosvix.com/api-keys");
-    process.exit(1);
+const argv = process.argv.slice(2);
+// Codex LOW 5 fix: --http のみ受理 (= サブコマンド形式 `argosvix-mcp http` の曖昧
+// 判定を撤廃、 将来の引数追加と衝突しないように)
+const useHttp = argv.includes("--http");
+if (useHttp) {
+    const { runHttp } = await import("./http.js");
+    await runHttp();
 }
-const server = new Server({
-    name: "argosvix",
-    version: "0.2.0-alpha.1",
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-    tools,
-}));
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    return dispatchTool({
-        name,
-        args: args ?? {},
-        apiKey: API_KEY,
-        apiBase: API_BASE,
+else {
+    const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const { CallToolRequestSchema, ListToolsRequestSchema } = await import("@modelcontextprotocol/sdk/types.js");
+    const { tools, dispatchTool } = await import("./tools.js");
+    const API_KEY = process.env["ARGOSVIX_API_KEY"];
+    const API_BASE = process.env["ARGOSVIX_API_BASE"] ?? "https://ingest.argosvix.com";
+    if (!API_KEY) {
+        // eslint-disable-next-line no-console
+        console.error("[argosvix-mcp] ARGOSVIX_API_KEY env var is required for stdio mode. " +
+            "Get a key at https://dashboard.argosvix.com/api-keys " +
+            "(use --http flag for HTTP transport with per-request auth)");
+        process.exit(1);
+    }
+    const server = new Server({
+        name: "argosvix",
+        version: "0.3.1-alpha.1",
+    }, {
+        capabilities: {
+            tools: {},
+        },
     });
-});
-const transport = new StdioServerTransport();
-await server.connect(transport);
-console.error("[argosvix-mcp] server ready on stdio transport");
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return dispatchTool({
+            name,
+            args: args ?? {},
+            apiKey: API_KEY,
+            apiBase: API_BASE,
+        });
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // eslint-disable-next-line no-console
+    console.error("[argosvix-mcp] argosvix@0.3.1-alpha.1 ready on stdio transport");
+}
+export {};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,6BAA6B,CAAC;AAEnF,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CACX,uDAAuD;QACrD,sDAAsD,CACzD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;IACE,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,eAAe;CACzB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK;CACN,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IACjD,OAAO,YAAY,CAAC;QAClB,IAAI;QACJ,IAAI,EAAE,IAAI,IAAI,EAAE;QAChB,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,QAAQ;KAClB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAChC,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,mEAAmE;AACnE,2BAA2B;AAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAExC,IAAI,OAAO,EAAE,CAAC;IACZ,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,OAAO,EAAE,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;IAC7E,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAC3C,2CAA2C,CAC5C,CAAC;IACF,MAAM,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CACpE,oCAAoC,CACrC,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IAE3D,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,6BAA6B,CAAC;IAEpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,sEAAsE;YACpE,uDAAuD;YACvD,4DAA4D,CAC/D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,eAAe;KACzB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5D,KAAK;KACN,CAAC,CAAC,CAAC;IAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QACjD,OAAO,YAAY,CAAC;YAClB,IAAI;YACJ,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;AAClF,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,27 @@
+/**
+ * MCP prompt definitions + handler (= Phase 3、 2026-05-31)。
+ *
+ * Prompt は 「user が 明示的に 選んで 起動する template message」 (= slash command 的)。
+ * Argosvix では 「LLM observability の 典型 query」 を 1 click で 投入できる scaffold
+ * として 3 件 用意する。 各 prompt は user role の text 1 件で、 内容として 必要な
+ * argosvix tool 呼出しを agent に 指示する。
+ *
+ * v1 prompts:
+ *   - cost_review       = 今月 + 直近 7 日の cost トレンドを分析、 異常を report
+ *   - alert_audit       = 現 alert 設定を 監査し、 plan / 用途に応じた 改善案を出す
+ *   - incident_triage   = 直近 N 時間の error / latency 異常を 調査、 root cause を推定
+ *
+ * v1.5 候補: 動的 argument 補完 (= completion API)、 model 別 / provider 別 template。
+ */
+import type { Prompt, GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+export declare const prompts: Prompt[];
+export interface GetPromptInput {
+    name: string;
+    args: Record<string, unknown>;
+}
+export declare class PromptNotFoundError extends Error {
+    promptName: string;
+    constructor(promptName: string);
+}
+export declare function getPrompt(input: GetPromptInput): GetPromptResult;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,OAAO,EAAE,MAAM,EAwC3B,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IACzB,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAItC;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,eAAe,CAYhE"}

package/dist/prompts.js

@@ -0,0 +1,169 @@
+/**
+ * MCP prompt definitions + handler (= Phase 3、 2026-05-31)。
+ *
+ * Prompt は 「user が 明示的に 選んで 起動する template message」 (= slash command 的)。
+ * Argosvix では 「LLM observability の 典型 query」 を 1 click で 投入できる scaffold
+ * として 3 件 用意する。 各 prompt は user role の text 1 件で、 内容として 必要な
+ * argosvix tool 呼出しを agent に 指示する。
+ *
+ * v1 prompts:
+ *   - cost_review       = 今月 + 直近 7 日の cost トレンドを分析、 異常を report
+ *   - alert_audit       = 現 alert 設定を 監査し、 plan / 用途に応じた 改善案を出す
+ *   - incident_triage   = 直近 N 時間の error / latency 異常を 調査、 root cause を推定
+ *
+ * v1.5 候補: 動的 argument 補完 (= completion API)、 model 別 / provider 別 template。
+ */
+export const prompts = [
+    {
+        name: "cost_review",
+        title: "コスト傾向レビュー",
+        description: "argosvix の get_cost_summary tool を 24h / 7d / 30d で順に呼び、 provider 別 " +
+            "breakdown を比較して 異常 (= 急増 / 一極集中 / 想定外モデル) を 指摘する。 " +
+            "month argument を 渡すと 「先月との 差分」 を 念頭に置いた analysis に carry。",
+        arguments: [
+            {
+                name: "month",
+                description: "比較対象月 (= YYYY-MM 形式、 例 2026-04)。 省略すると 今月のみ 評価。",
+                required: false,
+            },
+        ],
+    },
+    {
+        name: "alert_audit",
+        title: "アラート設定 監査",
+        description: "argosvix の list_alerts tool で 全 alert を取得し、 plan の制約 (= Free / Pro / Team) と " +
+            "実 cost / error rate を 突き合わせて、 通知 channel / sleepMinutes / threshold が 適切か " +
+            "review する。 重複 alert や silence しっぱなしの alert も 検出して 提案を出す。",
+    },
+    {
+        name: "incident_triage",
+        title: "インシデント トリアージ",
+        description: "直近 N 時間の error / latency 異常を 調査する。 list_alert_events で 最近の trigger を " +
+            "確認し、 query_calls で 該当時間帯の生データを引いて、 root cause (= 特定 model / " +
+            "provider 障害 / cost spike) を 推定して report する。",
+        arguments: [
+            {
+                name: "hours",
+                description: "調査する遡及時間 (= 例 6 / 24 / 72)。 省略時は 24。",
+                required: false,
+            },
+        ],
+    },
+];
+export class PromptNotFoundError extends Error {
+    promptName;
+    constructor(promptName) {
+        super(`prompt not found: ${promptName}`);
+        this.promptName = promptName;
+        this.name = "PromptNotFoundError";
+    }
+}
+export function getPrompt(input) {
+    const { name, args } = input;
+    switch (name) {
+        case "cost_review":
+            return buildCostReview(args);
+        case "alert_audit":
+            return buildAlertAudit();
+        case "incident_triage":
+            return buildIncidentTriage(args);
+        default:
+            throw new PromptNotFoundError(name);
+    }
+}
+function buildCostReview(args) {
+    const month = sanitizeMonth(args["month"]);
+    const monthLine = month
+        ? `\n比較対象月: ${month} (= 先月との差分も 念頭に置いて分析する)`
+        : "\n今月 + 直近 7 日のみを 評価する (= 比較対象月の指定なし)。";
+    return {
+        description: "Argosvix の cost トレンドを 自動分析する prompt",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Argosvix tool を使って LLM cost の トレンドを分析してください。\n\n" +
+                        "実行手順:\n" +
+                        "1. get_cost_summary(rangePreset=\"24h\", groupBy=\"provider\") を呼んで 直近 24h の cost を取得\n" +
+                        "2. get_cost_summary(rangePreset=\"7d\", groupBy=\"provider\") を 7d で取得\n" +
+                        "3. get_cost_summary(rangePreset=\"30d\", groupBy=\"provider\") を 30d で取得\n" +
+                        "4. provider 別 breakdown を比較し、 以下を report する:\n" +
+                        "   - 全体 cost の trend (= 増 / 減 / 安定)\n" +
+                        "   - provider シェアの偏り (= 1 provider に 80% 集中 等)\n" +
+                        "   - 想定外モデル (= 上位 model に コスト上 違和感ない か)\n" +
+                        "   - 24h スパイク (= 30d 平均 比で 異常 か)\n" +
+                        monthLine,
+                },
+            },
+        ],
+    };
+}
+function buildAlertAudit() {
+    return {
+        description: "Argosvix alert 設定を 監査して 改善案を 出す prompt",
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Argosvix の alert 設定を 監査してください。\n\n" +
+                        "実行手順:\n" +
+                        "1. list_alerts(includeTriggered=true) で 全 alert + 直近 trigger 状況を取得\n" +
+                        "2. 各 alert について 以下を review:\n" +
+                        "   - threshold の妥当性 (= 実 cost / error rate / latency 分布に対して 過敏 or 緩すぎないか)\n" +
+                        "   - sleepMinutes (= 連続発火を抑制する間隔、 5 分未満は alert 嵐の温床)\n" +
+                        "   - channel (= Free plan で email のみ / Pro+ で 適切な channel を 使えているか)\n" +
+                        "   - 重複 (= 同じ provider × 同じ閾値で 複数 alert が ないか)\n" +
+                        "   - silence しっぱなし (= 長期間 silenced で 実質 disable に なっていないか)\n" +
+                        "3. 改善案を 「重要度: 高 / 中 / 低」 で 仕分けて 出力する。",
+                },
+            },
+        ],
+    };
+}
+function buildIncidentTriage(args) {
+    const hours = sanitizeHours(args["hours"]);
+    return {
+        description: `直近 ${hours}h の error / latency 異常を triage する prompt`,
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `直近 ${hours} 時間の error / latency 異常を 調査してください。\n\n` +
+                        "実行手順:\n" +
+                        `1. list_alert_events(limit=50) で 直近 ${hours} 時間の trigger 履歴を取得\n` +
+                        `2. 異常な provider / model が 浮上したら query_calls(rangePreset="24h", limit=200) で 該当 ` +
+                        "record を引く (= provider / model で filter)\n" +
+                        "3. root cause を 以下のいずれかに分類:\n" +
+                        "   - 特定 provider の障害 (= 全 model で error 同時上昇)\n" +
+                        "   - 特定 model の degradation (= 同 provider 内で 1 model のみ error)\n" +
+                        "   - cost spike (= 想定外 model の 過剰呼び出し / loop)\n" +
+                        "   - latency 上昇 (= timeout 起因か、 prompt 長 起因か)\n" +
+                        "4. 推定された root cause + 推奨アクションを report。",
+                },
+            },
+        ],
+    };
+}
+function sanitizeMonth(value) {
+    if (typeof value !== "string")
+        return null;
+    // YYYY-MM 形式のみ受理 (= prompt text 注入防御)
+    return /^\d{4}-\d{2}$/.test(value) ? value : null;
+}
+function sanitizeHours(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        const n = Math.floor(value);
+        if (n >= 1 && n <= 168)
+            return n;
+    }
+    if (typeof value === "string") {
+        const n = Number.parseInt(value, 10);
+        if (Number.isFinite(n) && n >= 1 && n <= 168)
+            return n;
+    }
+    return 24;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MCP resource definitions + reader (= Phase 3、 2026-05-31)。
+ *
+ * Resource は 「AI agent に 自動的に 文脈として渡す read-only data」 (= tools が
+ * 「呼ぶ」 のに対し resource は 「読み込む」)。 host application が 自前で 選んで
+ * context に入れるか、 prompt から `resource` content として 埋め込むことができる。
+ *
+ * v1 で expose する静的 resource は account の現状を スナップショットで返す 3 つ:
+ *   - argosvix://account        = plan / quota / 今月の使用量 (= /v1/billing/status)
+ *   - argosvix://alerts/active  = enabled な alert 一覧 (= /v1/alerts から filter)
+ *   - argosvix://cost/today     = 直近 24h の cost 集計 (= /v1/query/aggregate)
+ *
+ * v1.5 候補: resource template (= argosvix://calls/{id} 等)、 subscribe / listChanged。
+ */
+import type { Resource } from "@modelcontextprotocol/sdk/types.js";
+export declare const resources: Resource[];
+export interface ReadResourceInput {
+    uri: string;
+    apiKey: string;
+    apiBase: string;
+}
+export interface ResourceContentText {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function readResource(input: ReadResourceInput): Promise<{
+    contents: ResourceContentText[];
+}>;
+export declare class ResourceNotFoundError extends Error {
+    uri: string;
+    constructor(uri: string);
+}
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAMnE,eAAO,MAAM,SAAS,EAAE,QAAQ,EA4B/B,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC;IAAE,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC,CA8B9C;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAC3B,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAI/B"}

package/dist/resources.js

@@ -0,0 +1,123 @@
+/**
+ * MCP resource definitions + reader (= Phase 3、 2026-05-31)。
+ *
+ * Resource は 「AI agent に 自動的に 文脈として渡す read-only data」 (= tools が
+ * 「呼ぶ」 のに対し resource は 「読み込む」)。 host application が 自前で 選んで
+ * context に入れるか、 prompt から `resource` content として 埋め込むことができる。
+ *
+ * v1 で expose する静的 resource は account の現状を スナップショットで返す 3 つ:
+ *   - argosvix://account        = plan / quota / 今月の使用量 (= /v1/billing/status)
+ *   - argosvix://alerts/active  = enabled な alert 一覧 (= /v1/alerts から filter)
+ *   - argosvix://cost/today     = 直近 24h の cost 集計 (= /v1/query/aggregate)
+ *
+ * v1.5 候補: resource template (= argosvix://calls/{id} 等)、 subscribe / listChanged。
+ */
+const ACCOUNT_URI = "argosvix://account";
+const ALERTS_ACTIVE_URI = "argosvix://alerts/active";
+const COST_TODAY_URI = "argosvix://cost/today";
+export const resources = [
+    {
+        uri: ACCOUNT_URI,
+        name: "account",
+        title: "Argosvix アカウント",
+        description: "現在のアカウントの plan / quota / 今月の record 使用量 / retention 設定の snapshot。 " +
+            "billing status endpoint をそのまま JSON で返す。",
+        mimeType: "application/json",
+    },
+    {
+        uri: ALERTS_ACTIVE_URI,
+        name: "alerts_active",
+        title: "現 active alert 一覧",
+        description: "enabled な alert の一覧 (= silenced も含む、 enabled=false は除外)。 " +
+            "list_alerts tool が返す形と同じ shape を snapshot として返す。",
+        mimeType: "application/json",
+    },
+    {
+        uri: COST_TODAY_URI,
+        name: "cost_today",
+        title: "今日の cost summary",
+        description: "直近 24 時間の cost / call / token 集計を provider 別 breakdown 付きで snapshot。 " +
+            "get_cost_summary(rangePreset=24h, groupBy=provider) と同等。",
+        mimeType: "application/json",
+    },
+];
+export async function readResource(input) {
+    const { uri, apiKey, apiBase } = input;
+    switch (uri) {
+        case ACCOUNT_URI:
+            return await fetchAsResource(uri, apiBase, "/v1/billing/status", {}, apiKey);
+        case ALERTS_ACTIVE_URI: {
+            const raw = await fetchJson(apiBase, "/v1/alerts", {}, apiKey);
+            const filtered = filterEnabledAlerts(raw);
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "application/json",
+                        text: JSON.stringify(filtered, null, 2),
+                    },
+                ],
+            };
+        }
+        case COST_TODAY_URI:
+            return await fetchAsResource(uri, apiBase, "/v1/query/aggregate", { rangePreset: "24h", groupBy: "provider" }, apiKey);
+        default:
+            // -32002 Resource not found を 上位で投げてもらう用に Error throw
+            throw new ResourceNotFoundError(uri);
+    }
+}
+export class ResourceNotFoundError extends Error {
+    uri;
+    constructor(uri) {
+        super(`resource not found: ${uri}`);
+        this.uri = uri;
+        this.name = "ResourceNotFoundError";
+    }
+}
+async function fetchAsResource(uri, apiBase, path, query, apiKey) {
+    const json = await fetchJson(apiBase, path, query, apiKey);
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(json, null, 2),
+            },
+        ],
+    };
+}
+async function fetchJson(apiBase, path, query, apiKey) {
+    const url = new URL(path, apiBase);
+    for (const [k, v] of Object.entries(query))
+        url.searchParams.set(k, v);
+    const res = await fetch(url.toString(), {
+        method: "GET",
+        redirect: "error",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+            "User-Agent": "argosvix-mcp-server-resource",
+        },
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`Argosvix API ${path} returned ${res.status}: ${body.slice(0, 300)}`);
+    }
+    return await res.json();
+}
+function filterEnabledAlerts(raw) {
+    // backend list_alerts は { alerts: [...] } 形式を 返す想定。 unknown shape にも
+    // 安全に対処 (= alert key 無ければそのまま返す)。
+    if (typeof raw === "object" &&
+        raw !== null &&
+        "alerts" in raw &&
+        Array.isArray(raw.alerts)) {
+        const alerts = raw.alerts;
+        return {
+            ...raw,
+            alerts: alerts.filter((a) => a["enabled"] !== false),
+        };
+    }
+    return raw;
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AACrD,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAE/C,MAAM,CAAC,MAAM,SAAS,GAAe;IACnC;QACE,GAAG,EAAE,WAAW;QAChB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,oEAAoE;YACpE,yCAAyC;QAC3C,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,iBAAiB;QACtB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,2DAA2D;YAC3D,kDAAkD;QACpD,QAAQ,EAAE,kBAAkB;KAC7B;IACD;QACE,GAAG,EAAE,cAAc;QACnB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,uEAAuE;YACvE,0DAA0D;QAC5D,QAAQ,EAAE,kBAAkB;KAC7B;CACF,CAAC;AAcF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAwB;IAExB,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IACvC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,WAAW;YACd,OAAO,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/E,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YAC/D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAC1C,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG;wBACH,QAAQ,EAAE,kBAAkB;wBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;qBACxC;iBACF;aACF,CAAC;QACJ,CAAC;QACD,KAAK,cAAc;YACjB,OAAO,MAAM,eAAe,CAC1B,GAAG,EACH,OAAO,EACP,qBAAqB,EACrB,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,EAC3C,MAAM,CACP,CAAC;QACJ;YACE,sDAAsD;YACtD,MAAM,IAAI,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC3B;IAAnB,YAAmB,GAAW;QAC5B,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QADnB,QAAG,GAAH,GAAG,CAAQ;QAE5B,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,KAAK,UAAU,eAAe,CAC5B,GAAW,EACX,OAAe,EACf,IAAY,EACZ,KAA6B,EAC7B,MAAc;IAEd,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,GAAG;gBACH,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,OAAe,EACf,IAAY,EACZ,KAA6B,EAC7B,MAAc;IAEd,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;QACtC,MAAM,EAAE,KAAK;QACb,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,MAAM,EAAE;YACjC,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,8BAA8B;SAC7C;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,gBAAgB,IAAI,aAAa,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAY;IACvC,qEAAqE;IACrE,kCAAkC;IAClC,IACE,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,QAAQ,IAAI,GAAG;QACf,KAAK,CAAC,OAAO,CAAE,GAA2B,CAAC,MAAM,CAAC,EAClD,CAAC;QACD,MAAM,MAAM,GAAI,GAAkD,CAAC,MAAM,CAAC;QAC1E,OAAO;YACL,GAAG,GAAG;YACN,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC;SACrD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAoC/D,eAAO,MAAM,KAAK,EAAE,IAAI,EAqRvB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAiFD"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAwC/D,eAAO,MAAM,KAAK,EAAE,IAAI,EAuRvB,CAAC;AAEF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC;IAChE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAqID"}