@lessie/mcp-server 0.0.3 → 0.0.6

package/SKILL.md

@@ -0,0 +1,130 @@
+---
+name: lessie-api
+description: >-
+  调用 Lessie API 的标准流程：API Key 换取 JWT、JWT 缓存刷新、通用请求封装。
+  当需要对接 Lessie 后端、调用 Lessie API、或实现鉴权流程时使用。
+---
+
+# Lessie API 调用流程
+
+## 鉴权：API Key → JWT
+
+环境变量：
+
+- `LESSIE_BASE_URL` — 后端地址，默认 `https://www.lessie.ai/prod-api`
+- `LESSIE_API_KEY` — 用户的 API Key（`sk-live-v1-xxx`）
+
+### 换取 JWT
+
+```typescript
+const res = await fetch(`${LESSIE_BASE_URL}/auth/token`, {
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ apiKey: LESSIE_API_KEY }),
+});
+const body = await res.json();
+// body 结构: { code: number, msg: string, data: { token: string, expiresIn: number } }
+const { token, expiresIn } = body.data;
+```
+
+- `expiresIn` 单位为秒（通常 3600 = 1 小时）
+- 错误统一返回 401，不区分"不存在"和"已吊销"
+
+### JWT 缓存与刷新
+
+在内存中缓存 `{ token, expiry }`，每次请求前检查：
+
+- 若缓存不存在，或距过期不足 **60 秒**，重新调用 `/auth/token` 换取
+- 进程重启后需重新获取
+
+```typescript
+interface JwtCache {
+  token: string;
+  expiry: number; // Unix timestamp (ms)
+}
+
+let jwtCache: JwtCache | null = null;
+
+async function getJwt(): Promise<string> {
+  const now = Date.now();
+  if (jwtCache && jwtCache.expiry - now > 60_000) {
+    return jwtCache.token;
+  }
+
+  const res = await fetch(`${LESSIE_BASE_URL}/auth/token`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ apiKey: LESSIE_API_KEY }),
+  });
+
+  if (!res.ok) {
+    throw new Error(`Failed to exchange API key for JWT: ${res.status}`);
+  }
+
+  const body = await res.json() as {
+    code: number; msg: string;
+    data: { token: string; expiresIn: number };
+  };
+
+  jwtCache = {
+    token: body.data.token,
+    expiry: now + body.data.expiresIn * 1000,
+  };
+  return jwtCache.token;
+}
+```
+
+## 通用请求封装
+
+```typescript
+async function api<T = unknown>(
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
+  path: string,
+  body?: unknown,
+): Promise<T> {
+  const token = await getJwt();
+
+  const res = await fetch(`${LESSIE_BASE_URL}${path}`, {
+    method,
+    headers: {
+      Authorization: token,
+      "Content-Type": "application/json",
+    },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  });
+
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`API error ${res.status}${text ? `: ${text}` : ""}`);
+  }
+
+  if (res.status === 204) return undefined as T;
+
+  const wrapper = await res.json() as { code: number; msg: string; data: T };
+  return wrapper.data;
+}
+```
+
+要点：
+
+- Authorization header 直接传 token（不加 `Bearer ` 前缀）
+- 后端统一返回 `{ code, msg, data }`，`api()` 自动解包返回 `data`
+- 所有 Agent 端点路径以 `/agent/` 开头
+
+## 调用示例
+
+```typescript
+// GET 无参数
+const info = await api("GET", "/agent/account/info");
+
+// GET 带查询参数
+const params = new URLSearchParams({ page: "1", status: "active" });
+const list = await api("GET", `/agent/projects?${params}`);
+
+// POST 带请求体
+const result = await api("POST", "/agent/projects", {
+  name: "新项目",
+  description: "项目描述",
+});
+```
+

package/dist/index.js

@@ -1,15 +1,28 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+function loadInstructions() {
+    try {
+        const raw = readFileSync(new URL("../SKILL.md", import.meta.url), "utf-8");
+        return raw.replace(/^---[\s\S]*?---\n*/, "").trim() || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 // ── 环境变量 ──────────────────────────────────────────────────────────────────
-const BASE_URL = process.env.SAAS_BASE_URL;
-const API_KEY = process.env.SAAS_API_KEY;
+const BASE_URL = process.env.LESSIE_BASE_URL || 'https://www.lessie.ai/prod-api';
+const API_KEY = process.env.LESSIE_API_KEY;
 if (!BASE_URL) {
-    console.error("Error: SAAS_BASE_URL is not set");
+    console.error("Error: LESSIE_BASE_URL is not set");
     process.exit(1);
 }
 if (!API_KEY) {
-    console.error("Error: SAAS_API_KEY is not set");
+    console.error("Error: LESSIE_API_KEY is not set");
     process.exit(1);
 }
 let jwtCache = null;
@@ -31,20 +44,22 @@ async function getJwt() {
     if (!res.ok) {
         throw new Error(`Failed to exchange API key for JWT: ${res.status} ${res.statusText} ${BASE_URL}/auth/token`);
     }
-    const data = (await res.json());
+    const body = (await res.json());
+    if (!body.data?.token) {
+        throw new Error(`/auth/token response missing data.token. Got: ${JSON.stringify(body)}`);
+    }
     jwtCache = {
-        token: data.token,
-        expiry: now + data.expiresIn * 1000,
+        token: body.data.token,
+        expiry: now + body.data.expiresIn * 1000,
     };
     return jwtCache.token;
 }
-// ── 通用请求封装 ───────────────────────────────────────────────────────────────
 async function api(method, path, body) {
     const token = await getJwt();
     const res = await fetch(`${BASE_URL}${path}`, {
         method,
         headers: {
-            "Authorization": `Bearer ${token}`,
+            "Authorization": token,
             "Content-Type": "application/json",
         },
         body: body !== undefined ? JSON.stringify(body) : undefined,
@@ -55,7 +70,8 @@ async function api(method, path, body) {
     }
     if (res.status === 204)
         return undefined;
-    return res.json();
+    const wrapper = (await res.json());
+    return wrapper.data;
 }
 // ── 工具结果辅助函数 ───────────────────────────────────────────────────────────
 function textResult(data) {
@@ -66,12 +82,21 @@ function textResult(data) {
 // ── MCP Server ────────────────────────────────────────────────────────────────
 const server = new McpServer({
     name: "lessie-mcp",
-    version: "1.0.0",
+    version: pkg.version,
+}, {
+    instructions: loadInstructions(),
 });
 // ── 工具定义 ──────────────────────────────────────────────────────────────────
 // 命名规范：下划线分隔，动词开头（如 list_xxx、get_xxx、create_xxx）。
 // 写入类工具在 description 中注明"执行前请向用户确认"。
-// 账号信息
+server.tool("get_jwt", "获取当前有效的 JWT token，可用于直接调用 Lessie API。返回 token 字符串和剩余有效时间。", {}, async () => {
+    const token = await getJwt();
+    const remainingMs = jwtCache ? jwtCache.expiry - Date.now() : 0;
+    return textResult({
+        token,
+        remainingSeconds: Math.max(0, Math.floor(remainingMs / 1000)),
+    });
+});
 server.tool("get_account_info", "查看当前 Lessie 账号的详细信息，包括用户名、邮箱、账号状态、角色、邀请码等。", {}, async () => {
     const data = await api("GET", "/agent/account/info");
     return textResult(data);
@@ -79,3 +104,14 @@ server.tool("get_account_info", "查看当前 Lessie 账号的详细信息，包
 // ── 启动 ──────────────────────────────────────────────────────────────────────
 const transport = new StdioServerTransport();
 await server.connect(transport);
+await getJwt();
+server.sendLoggingMessage({
+    level: "info",
+    logger: "lessie",
+    data: "Token acquired successfully",
+});
+server.sendLoggingMessage({
+    level: "info",
+    logger: "lessie",
+    data: `Lessie MCP Server v${pkg.version} started`,
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lessie/mcp-server",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "type": "module",
   "main": "dist/index.js",
   "bin": {