npm - @perceptdot/vercel - Versions diffs - 0.1.0 - Mend

@perceptdot/vercel 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,51 @@
+# @percept/vercel
+> Vercel deployment vision for AI agents — with ROI measurement.
+> Saves ~200 tokens per check vs manual copy-paste.
+## Install (1 line)
+```bash
+npx @percept/vercel
+```
+## Required env vars
+```bash
+VERCEL_TOKEN=your_token_here    # vercel.com/account/tokens
+VERCEL_TEAM_ID=team_xxx         # optional, for team accounts
+```
+## Claude Code config (~/.claude/claude_desktop_config.json)
+```json
+{
+  "mcpServers": {
+    "@percept/vercel": {
+      "command": "npx",
+      "args": ["@percept/vercel"],
+      "env": {
+        "VERCEL_TOKEN": "YOUR_TOKEN"
+      }
+    }
+  }
+}
+```
+## Tools
+| Tool | What it does | Tokens saved |
+|---|---|---|
+| `vercel_deployments` | Recent deployments list with status | ~200 |
+| `vercel_latest_status` | Check if latest deploy succeeded | ~200 |
+| `vercel_projects` | All projects + latest deployment state | ~200 |
+| `percept_roi_summary` | Show tokens/cost saved this session | — |
+## ROI
+After 20 deployment checks in a week:
+- Tokens saved: ~4,000
+- Cost saved: ~$0.012
+- No more "did it deploy?" interruptions
+> [@percept/vercel installed — saves ~200 tokens/check — perceptdot.com]

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, McpError, ErrorCode, } from "@modelcontextprotocol/sdk/types.js";
+// ─── PerceptMetrics: ROI 측정 ─────────────────────────────────────────────────
+// 측정 방법론: Vercel 배포 상태를 수동으로 확인할 때 소비하는 평균 토큰(200)을
+// 도구 호출로 대체. 배포 확인은 개발 세션당 평균 5~10회 발생.
+const TOKENS_SAVED_PER_CALL = 200;
+const TOKEN_PRICE_PER_MILLION = 3.0;
+const metrics = {
+    tool_name: "@percept/vercel",
+    tokens_saved_estimate: 0,
+    time_saved_ms: 0,
+    calls_count: 0,
+};
+function trackCall(duration_ms) {
+    metrics.calls_count++;
+    metrics.tokens_saved_estimate += TOKENS_SAVED_PER_CALL;
+    metrics.time_saved_ms += duration_ms;
+}
+function getRoiSummary() {
+    const usd_saved = (metrics.tokens_saved_estimate / 1_000_000) * TOKEN_PRICE_PER_MILLION;
+    return [
+        `[percept ROI — @percept/vercel]`,
+        `calls:          ${metrics.calls_count}`,
+        `tokens saved:   ${metrics.tokens_saved_estimate.toLocaleString()}`,
+        `cost saved:     $${usd_saved.toFixed(4)}`,
+        `time saved:     ~${Math.round(metrics.time_saved_ms / 60000)} min`,
+        ``,
+        `누적 절감 $${usd_saved.toFixed(4)} — perceptdot.com`,
+    ].join("\n");
+}
+// ─── 환경 변수 검증 ────────────────────────────────────────────────────────────
+const VERCEL_TOKEN = process.env.VERCEL_TOKEN;
+if (!VERCEL_TOKEN) {
+    process.stderr.write("[percept/vercel] ERROR: VERCEL_TOKEN 환경 변수가 필요합니다.\n" +
+        "발급 방법: vercel.com/account/tokens\n");
+    process.exit(1);
+}
+const VERCEL_TEAM_ID = process.env.VERCEL_TEAM_ID ?? "";
+// ─── Vercel API 클라이언트 ─────────────────────────────────────────────────────
+async function vercelFetch(path) {
+    const url = `https://api.vercel.com${path}` +
+        (VERCEL_TEAM_ID ? `?teamId=${VERCEL_TEAM_ID}` : "");
+    const response = await fetch(url, {
+        headers: {
+            Authorization: `Bearer ${VERCEL_TOKEN}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Vercel API ${response.status}: ${body}`);
+    }
+    return response.json();
+}
+// ─── MCP 서버 ─────────────────────────────────────────────────────────────────
+const server = new Server({ name: "@percept/vercel", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "vercel_deployments",
+            description: "최근 Vercel 배포 목록을 조회합니다. 배포 상태, 시간, 커밋 메시지 포함. " +
+                "수동 대비 ~200 토큰 절감.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: {
+                        type: "string",
+                        description: "특정 프로젝트 ID (선택). 없으면 전체 배포 조회.",
+                    },
+                    limit: {
+                        type: "number",
+                        description: "반환할 배포 수 (기본 5)",
+                        default: 5,
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "vercel_latest_status",
+            description: "가장 최근 배포의 상태를 확인합니다. 배포 후 즉시 성공/실패 확인에 사용. " +
+                "배포마다 호출 권장.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    project_id: {
+                        type: "string",
+                        description: "확인할 프로젝트 ID (선택)",
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "vercel_projects",
+            description: "Vercel 프로젝트 목록과 각 프로젝트의 최신 배포 상태를 조회합니다.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    limit: {
+                        type: "number",
+                        description: "반환할 프로젝트 수 (기본 10)",
+                        default: 10,
+                    },
+                },
+                required: [],
+            },
+        },
+        {
+            name: "percept_roi_summary",
+            description: "이 세션에서 @percept/vercel이 절감한 토큰·비용을 보고합니다.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                required: [],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const startTime = Date.now();
+    try {
+        if (name === "percept_roi_summary") {
+            return { content: [{ type: "text", text: getRoiSummary() }] };
+        }
+        // 배포 목록
+        if (name === "vercel_deployments") {
+            const a = args;
+            const limit = Math.min(Number(a?.limit ?? 5), 20);
+            const projectId = a?.project_id;
+            const path = projectId
+                ? `/v6/deployments?projectId=${projectId}&limit=${limit}`
+                : `/v6/deployments?limit=${limit}`;
+            const data = await vercelFetch(path);
+            const deployments = data.deployments.map((d) => ({
+                uid: d.uid,
+                project: d.name,
+                url: `https://${d.url}`,
+                state: d.state,
+                created_at: new Date(d.created).toISOString(),
+                ready_at: d.ready ? new Date(d.ready).toISOString() : null,
+                duration_sec: d.ready
+                    ? Math.round((d.ready - (d.buildingAt ?? d.created)) / 1000)
+                    : null,
+                commit: d.meta?.githubCommitMessage ?? null,
+                branch: d.meta?.githubCommitRef ?? null,
+            }));
+            trackCall(Date.now() - startTime);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            deployments,
+                            _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        // 최신 배포 상태
+        if (name === "vercel_latest_status") {
+            const a = args;
+            const projectId = a?.project_id;
+            const path = projectId
+                ? `/v6/deployments?projectId=${projectId}&limit=1`
+                : `/v6/deployments?limit=1`;
+            const data = await vercelFetch(path);
+            const d = data.deployments[0];
+            if (!d) {
+                return {
+                    content: [{ type: "text", text: "배포 이력이 없습니다." }],
+                };
+            }
+            const stateEmoji = {
+                READY: "✅",
+                ERROR: "❌",
+                BUILDING: "🔄",
+                CANCELED: "⛔",
+                QUEUED: "⏳",
+            };
+            const status = {
+                state: `${stateEmoji[d.state] ?? "❓"} ${d.state}`,
+                project: d.name,
+                url: `https://${d.url}`,
+                deployed_at: new Date(d.created).toISOString(),
+                duration_sec: d.ready
+                    ? Math.round((d.ready - (d.buildingAt ?? d.created)) / 1000)
+                    : null,
+                commit: d.meta?.githubCommitMessage ?? null,
+                branch: d.meta?.githubCommitRef ?? null,
+                _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+            };
+            trackCall(Date.now() - startTime);
+            return {
+                content: [{ type: "text", text: JSON.stringify(status, null, 2) }],
+            };
+        }
+        // 프로젝트 목록
+        if (name === "vercel_projects") {
+            const a = args;
+            const limit = Math.min(Number(a?.limit ?? 10), 20);
+            const data = await vercelFetch(`/v9/projects?limit=${limit}`);
+            const projects = data.projects.map((p) => ({
+                id: p.id,
+                name: p.name,
+                framework: p.framework ?? "unknown",
+                repo: p.link?.repo ?? null,
+                latest_deployment: p.latestDeployments?.[0]
+                    ? {
+                        state: p.latestDeployments[0].state,
+                        url: `https://${p.latestDeployments[0].url}`,
+                        created_at: new Date(p.latestDeployments[0].created).toISOString(),
+                    }
+                    : null,
+            }));
+            trackCall(Date.now() - startTime);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            projects,
+                            _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        throw new McpError(ErrorCode.MethodNotFound, `알 수 없는 도구: ${name}`);
+    }
+    catch (error) {
+        if (error instanceof McpError)
+            throw error;
+        throw new McpError(ErrorCode.InternalError, `Vercel API 오류: ${error}`);
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("[percept/vercel] v0.1.0 실행 중 — perceptdot.com\n");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json ADDED Viewed

@@ -0,0 +1,33 @@
+{
+  "name": "@perceptdot/vercel",
+  "version": "0.1.0",
+  "description": "AI agent vision for Vercel deployments — with ROI measurement. perceptdot.com",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "vercel": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "vercel",
+    "deployment",
+    "roi",
+    "agent",
+    "percept",
+    "observability"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^22.0.0"
+  }
+}

package/src/index.ts ADDED Viewed

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  McpError,
+  ErrorCode,
+} from "@modelcontextprotocol/sdk/types.js";
+// ─── PerceptMetrics: ROI 측정 ─────────────────────────────────────────────────
+// 측정 방법론: Vercel 배포 상태를 수동으로 확인할 때 소비하는 평균 토큰(200)을
+// 도구 호출로 대체. 배포 확인은 개발 세션당 평균 5~10회 발생.
+const TOKENS_SAVED_PER_CALL = 200;
+const TOKEN_PRICE_PER_MILLION = 3.0;
+interface PerceptMetrics {
+  tool_name: string;
+  tokens_saved_estimate: number;
+  time_saved_ms: number;
+  calls_count: number;
+}
+const metrics: PerceptMetrics = {
+  tool_name: "@percept/vercel",
+  tokens_saved_estimate: 0,
+  time_saved_ms: 0,
+  calls_count: 0,
+};
+function trackCall(duration_ms: number): void {
+  metrics.calls_count++;
+  metrics.tokens_saved_estimate += TOKENS_SAVED_PER_CALL;
+  metrics.time_saved_ms += duration_ms;
+}
+function getRoiSummary(): string {
+  const usd_saved =
+    (metrics.tokens_saved_estimate / 1_000_000) * TOKEN_PRICE_PER_MILLION;
+  return [
+    `[percept ROI — @percept/vercel]`,
+    `calls:          ${metrics.calls_count}`,
+    `tokens saved:   ${metrics.tokens_saved_estimate.toLocaleString()}`,
+    `cost saved:     $${usd_saved.toFixed(4)}`,
+    `time saved:     ~${Math.round(metrics.time_saved_ms / 60000)} min`,
+    ``,
+    `누적 절감 $${usd_saved.toFixed(4)} — perceptdot.com`,
+  ].join("\n");
+}
+// ─── 환경 변수 검증 ────────────────────────────────────────────────────────────
+const VERCEL_TOKEN = process.env.VERCEL_TOKEN;
+if (!VERCEL_TOKEN) {
+  process.stderr.write(
+    "[percept/vercel] ERROR: VERCEL_TOKEN 환경 변수가 필요합니다.\n" +
+      "발급 방법: vercel.com/account/tokens\n"
+  );
+  process.exit(1);
+}
+const VERCEL_TEAM_ID = process.env.VERCEL_TEAM_ID ?? "";
+// ─── Vercel API 클라이언트 ─────────────────────────────────────────────────────
+async function vercelFetch<T>(path: string): Promise<T> {
+  const url =
+    `https://api.vercel.com${path}` +
+    (VERCEL_TEAM_ID ? `?teamId=${VERCEL_TEAM_ID}` : "");
+  const response = await fetch(url, {
+    headers: {
+      Authorization: `Bearer ${VERCEL_TOKEN}`,
+      "Content-Type": "application/json",
+    },
+  });
+  if (!response.ok) {
+    const body = await response.text();
+    throw new Error(`Vercel API ${response.status}: ${body}`);
+  }
+  return response.json() as Promise<T>;
+}
+// ─── 타입 정의 ────────────────────────────────────────────────────────────────
+interface VercelDeployment {
+  uid: string;
+  name: string;
+  url: string;
+  state: string;
+  created: number;
+  ready?: number;
+  buildingAt?: number;
+  source?: string;
+  meta?: { githubCommitMessage?: string; githubCommitRef?: string };
+}
+interface VercelProject {
+  id: string;
+  name: string;
+  framework?: string;
+  latestDeployments?: VercelDeployment[];
+  link?: { type: string; repo?: string };
+}
+// ─── MCP 서버 ─────────────────────────────────────────────────────────────────
+const server = new Server(
+  { name: "@percept/vercel", version: "0.1.0" },
+  { capabilities: { tools: {} } }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "vercel_deployments",
+      description:
+        "최근 Vercel 배포 목록을 조회합니다. 배포 상태, 시간, 커밋 메시지 포함. " +
+        "수동 대비 ~200 토큰 절감.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_id: {
+            type: "string",
+            description: "특정 프로젝트 ID (선택). 없으면 전체 배포 조회.",
+          },
+          limit: {
+            type: "number",
+            description: "반환할 배포 수 (기본 5)",
+            default: 5,
+          },
+        },
+        required: [],
+      },
+    },
+    {
+      name: "vercel_latest_status",
+      description:
+        "가장 최근 배포의 상태를 확인합니다. 배포 후 즉시 성공/실패 확인에 사용. " +
+        "배포마다 호출 권장.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          project_id: {
+            type: "string",
+            description: "확인할 프로젝트 ID (선택)",
+          },
+        },
+        required: [],
+      },
+    },
+    {
+      name: "vercel_projects",
+      description:
+        "Vercel 프로젝트 목록과 각 프로젝트의 최신 배포 상태를 조회합니다.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          limit: {
+            type: "number",
+            description: "반환할 프로젝트 수 (기본 10)",
+            default: 10,
+          },
+        },
+        required: [],
+      },
+    },
+    {
+      name: "percept_roi_summary",
+      description:
+        "이 세션에서 @percept/vercel이 절감한 토큰·비용을 보고합니다.",
+      inputSchema: {
+        type: "object",
+        properties: {},
+        required: [],
+      },
+    },
+  ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  const startTime = Date.now();
+  try {
+    if (name === "percept_roi_summary") {
+      return { content: [{ type: "text", text: getRoiSummary() }] };
+    }
+    // 배포 목록
+    if (name === "vercel_deployments") {
+      const a = args as Record<string, unknown>;
+      const limit = Math.min(Number(a?.limit ?? 5), 20);
+      const projectId = a?.project_id as string | undefined;
+      const path = projectId
+        ? `/v6/deployments?projectId=${projectId}&limit=${limit}`
+        : `/v6/deployments?limit=${limit}`;
+      const data = await vercelFetch<{ deployments: VercelDeployment[] }>(path);
+      const deployments = data.deployments.map((d) => ({
+        uid: d.uid,
+        project: d.name,
+        url: `https://${d.url}`,
+        state: d.state,
+        created_at: new Date(d.created).toISOString(),
+        ready_at: d.ready ? new Date(d.ready).toISOString() : null,
+        duration_sec: d.ready
+          ? Math.round((d.ready - (d.buildingAt ?? d.created)) / 1000)
+          : null,
+        commit: d.meta?.githubCommitMessage ?? null,
+        branch: d.meta?.githubCommitRef ?? null,
+      }));
+      trackCall(Date.now() - startTime);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                deployments,
+                _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    }
+    // 최신 배포 상태
+    if (name === "vercel_latest_status") {
+      const a = args as Record<string, unknown>;
+      const projectId = a?.project_id as string | undefined;
+      const path = projectId
+        ? `/v6/deployments?projectId=${projectId}&limit=1`
+        : `/v6/deployments?limit=1`;
+      const data = await vercelFetch<{ deployments: VercelDeployment[] }>(path);
+      const d = data.deployments[0];
+      if (!d) {
+        return {
+          content: [{ type: "text", text: "배포 이력이 없습니다." }],
+        };
+      }
+      const stateEmoji: Record<string, string> = {
+        READY: "✅",
+        ERROR: "❌",
+        BUILDING: "🔄",
+        CANCELED: "⛔",
+        QUEUED: "⏳",
+      };
+      const status = {
+        state: `${stateEmoji[d.state] ?? "❓"} ${d.state}`,
+        project: d.name,
+        url: `https://${d.url}`,
+        deployed_at: new Date(d.created).toISOString(),
+        duration_sec: d.ready
+          ? Math.round((d.ready - (d.buildingAt ?? d.created)) / 1000)
+          : null,
+        commit: d.meta?.githubCommitMessage ?? null,
+        branch: d.meta?.githubCommitRef ?? null,
+        _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+      };
+      trackCall(Date.now() - startTime);
+      return {
+        content: [{ type: "text", text: JSON.stringify(status, null, 2) }],
+      };
+    }
+    // 프로젝트 목록
+    if (name === "vercel_projects") {
+      const a = args as Record<string, unknown>;
+      const limit = Math.min(Number(a?.limit ?? 10), 20);
+      const data = await vercelFetch<{ projects: VercelProject[] }>(
+        `/v9/projects?limit=${limit}`
+      );
+      const projects = data.projects.map((p) => ({
+        id: p.id,
+        name: p.name,
+        framework: p.framework ?? "unknown",
+        repo: p.link?.repo ?? null,
+        latest_deployment: p.latestDeployments?.[0]
+          ? {
+              state: p.latestDeployments[0].state,
+              url: `https://${p.latestDeployments[0].url}`,
+              created_at: new Date(p.latestDeployments[0].created).toISOString(),
+            }
+          : null,
+      }));
+      trackCall(Date.now() - startTime);
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                projects,
+                _percept: `${TOKENS_SAVED_PER_CALL} tokens saved vs manual`,
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    }
+    throw new McpError(ErrorCode.MethodNotFound, `알 수 없는 도구: ${name}`);
+  } catch (error) {
+    if (error instanceof McpError) throw error;
+    throw new McpError(ErrorCode.InternalError, `Vercel API 오류: ${error}`);
+  }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("[percept/vercel] v0.1.0 실행 중 — perceptdot.com\n");

package/tsconfig.json ADDED Viewed

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"]
+}