mcp-jev 1.0.0

package/README.md

@@ -0,0 +1,190 @@
+# mcp-jev
+
+MCP server cho [TypeSafe Jev](https://typesafe.ai) — System One Model.
+
+Gửi state + typed questions → nhận calibrated probabilities. Không sinh text.
+
+## Tools
+
+| Tool | Khi nào dùng |
+|------|-------------|
+| `jev_decide` | Classify, route, check, score bất kỳ nội dung nào |
+| `jev_list_models` | Xem model IDs / aliases có sẵn trên API key của bạn |
+
+### `jev_decide`
+
+Đánh giá một hoặc nhiều câu hỏi trên cùng một `state` trong một request duy nhất.
+
+**3 loại câu hỏi (primitives):**
+
+| Type | Hỏi gì | Output |
+|------|--------|--------|
+| `noul` | Điều này có đúng không? | `noul`: probability 0–1 |
+| `choice` | Chọn 1 trong N options? | `choice` + `probabilities` + `confidence` |
+| `score` | Rate trên rubric này? | `score` (có thể là 1.04/3) + `probabilities` + `confidence` |
+
+**Ví dụ — triage support ticket:**
+
+```json
+{
+  "state": {
+    "message": "Payout của tôi bị fail 3 ngày rồi, tôi cần xử lý gấp!"
+  },
+  "questions": [
+    {
+      "id": "is_urgent",
+      "type": "noul",
+      "instructions": "Người dùng trong `message` có cần hỗ trợ khẩn cấp không?"
+    },
+    {
+      "id": "department",
+      "type": "choice",
+      "instructions": "Bộ phận nào nên xử lý `message`?",
+      "criteria": {
+        "billing": "Thanh toán, hoàn tiền, hóa đơn",
+        "technical": "Lỗi kỹ thuật, tích hợp API",
+        "general": "Câu hỏi chung không thuộc category trên"
+      }
+    },
+    {
+      "id": "frustration",
+      "type": "score",
+      "instructions": "Mức độ bực bội của người dùng trong `message` là bao nhiêu?",
+      "criteria": ["Bình thường", "Hơi khó chịu", "Rất bực bội"]
+    }
+  ]
+}
+```
+
+**Response mẫu:**
+
+```json
+{
+  "answers": {
+    "is_urgent": { "noul": 0.95 },
+    "department": {
+      "choice": "billing",
+      "probabilities": { "billing": 0.82, "technical": 0.12, "general": 0.06 },
+      "confidence": 0.80
+    },
+    "frustration": {
+      "score": 2.04,
+      "legend": "Rất bực bội",
+      "probabilities": { "Bình thường": 0.05, "Hơi khó chịu": 0.18, "Rất bực bội": 0.77 },
+      "confidence": 0.77
+    }
+  },
+  "model": "jev-1.13.0",
+  "usage": { "input_tokens": 312, "output_tokens": 0 }
+}
+```
+
+**Tips:**
+- Chỉ gửi state fields mà questions cần — context dư làm giảm độ chính xác
+- Reference fields bằng backtick: `` `message` ``, `` `order.id` ``
+- `choice.criteria` null = "no extra detail" (dùng cho bucket `other`)
+- `score.criteria` cần 2–10 levels, ordered thấp → cao
+
+---
+
+### `jev_list_models`
+
+Trả về danh sách model IDs và aliases.
+
+```json
+[
+  { "id": "jev-1.13.0", "aliases": ["jev-latest"] }
+]
+```
+
+Dùng khi muốn pin versioned ID thay vì `jev-latest` để tránh behavior thay đổi sau update.
+
+---
+
+## Cài đặt & cấu hình
+
+### Prerequisites
+
+- Node.js ≥ 20
+- TypeSafe API key — đăng ký waitlist tại [typesafe.ai](https://typesafe.ai)
+
+### Build
+
+```bash
+cd mcp-jev
+npm install
+npm run build
+```
+
+### Kiro (`.kiro/settings/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "jev": {
+      "command": "node",
+      "args": ["d:/github/crhead/mcp-jev/dist/index.js"],
+      "env": {
+        "TYPESAFE_API_KEY": "your_key_here"
+      },
+      "disabled": false
+    }
+  }
+}
+```
+
+### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "jev": {
+      "command": "node",
+      "args": ["/absolute/path/to/mcp-jev/dist/index.js"],
+      "env": {
+        "TYPESAFE_API_KEY": "your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Dev mode (không cần build)
+
+```bash
+TYPESAFE_API_KEY=your_key npx tsx src/index.ts
+```
+
+---
+
+## Biến môi trường
+
+| Biến | Bắt buộc | Mặc định | Mô tả |
+|------|----------|----------|-------|
+| `TYPESAFE_API_KEY` | ✅ | — | API key từ console.typesafe.ai |
+| `TYPESAFE_BASE_URL` | ❌ | `https://api.typesafe.ai` | Override URL (staging, proxy) |
+
+Server exit với code 1 ngay khi start nếu `TYPESAFE_API_KEY` không được set.
+
+---
+
+## Error handling
+
+| HTTP code | Ý nghĩa | Behavior |
+|-----------|---------|----------|
+| 401 | API key sai / thiếu | Trả về `isError: true` ngay |
+| 422 | Request body invalid | Trả về `isError: true` ngay + message chi tiết |
+| 429 | Rate limit | Retry tối đa 3 lần, exponential backoff |
+| 529 | Service overloaded | Retry tối đa 3 lần, exponential backoff |
+
+Rate limits hiện tại: 250,000 tokens/s · 1,200 requests/min.
+
+---
+
+## Giới hạn Jev
+
+- Chỉ nhận text (string, JSON object, JSON array) — không hỗ trợ image/audio/video
+- Context budget: ~64,000 tokens cho toàn bộ state + questions
+- Choice tối đa 255 options; Score 2–10 levels
+- Không thể dùng cho System 2 tasks (lập luận đa bước, sinh code, giải thích)
+- Model hiện tại: `jev-1.13.0` / alias `jev-latest`

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * MCP server for TypeSafe Jev — System One Model
+ *
+ * Tools:
+ *   jev_decide       — evaluate typed questions against a state using Jev
+ *   jev_list_models  — list available Jev model aliases
+ *
+ * Env:
+ *   TYPESAFE_API_KEY  (required)
+ *   TYPESAFE_BASE_URL (optional, default: https://api.typesafe.ai)
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,322 @@
+#!/usr/bin/env node
+/**
+ * MCP server for TypeSafe Jev — System One Model
+ *
+ * Tools:
+ *   jev_decide       — evaluate typed questions against a state using Jev
+ *   jev_list_models  — list available Jev model aliases
+ *
+ * Env:
+ *   TYPESAFE_API_KEY  (required)
+ *   TYPESAFE_BASE_URL (optional, default: https://api.typesafe.ai)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// ─── Config ─────────────────────────────────────────────────────────────────
+const API_KEY = process.env.TYPESAFE_API_KEY;
+const BASE_URL = process.env.TYPESAFE_BASE_URL?.replace(/\/$/, "") ??
+    "https://api.typesafe.ai";
+if (!API_KEY) {
+    process.stderr.write("[mcp-jev] FATAL: TYPESAFE_API_KEY environment variable is not set.\n");
+    process.exit(1);
+}
+// ─── Retry helper ───────────────────────────────────────────────────────────
+/**
+ * Fetch with exponential back-off for 429 / 529.
+ * Max 3 attempts, starting at 1s, doubling each retry.
+ */
+async function fetchWithRetry(url, init, attempts = 3, delayMs = 1000) {
+    if (attempts < 1)
+        throw new Error("fetchWithRetry: attempts must be >= 1");
+    let lastError;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        const resp = await fetch(url, init);
+        if (resp.status !== 429 && resp.status !== 529) {
+            return resp; // success or non-retryable error
+        }
+        // Respect Retry-After header if present (guard against NaN/negative)
+        const retryAfter = resp.headers.get("Retry-After");
+        const parsed = retryAfter ? parseInt(retryAfter, 10) : NaN;
+        const waitMs = !isNaN(parsed) && parsed > 0
+            ? parsed * 1000
+            : delayMs * Math.pow(2, attempt - 1); // true exponential: 1s, 2s, 4s
+        // Read body for error context before discarding the response
+        const body = await resp.text().catch(() => "");
+        if (attempt < attempts) {
+            await new Promise((r) => setTimeout(r, waitMs));
+        }
+        else {
+            lastError = new Error(`HTTP ${resp.status} after ${attempts} attempts — rate limited or overloaded. Response: ${body}`);
+        }
+    }
+    throw lastError ?? new Error("fetchWithRetry: unexpected loop exit");
+}
+// ─── Jev API helpers ────────────────────────────────────────────────────────
+async function callSystemOne(body) {
+    const resp = await fetchWithRetry(`${BASE_URL}/v1/systemone`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`Jev API error ${resp.status}: ${text}`);
+    }
+    try {
+        return await resp.json();
+    }
+    catch (e) {
+        throw new Error(`Failed to parse Jev API response as JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}
+async function listModels() {
+    const resp = await fetchWithRetry(`${BASE_URL}/v1/models`, {
+        method: "GET",
+        headers: { Authorization: `Bearer ${API_KEY}` },
+    });
+    if (!resp.ok) {
+        const text = await resp.text().catch(() => "");
+        throw new Error(`Jev API error ${resp.status}: ${text}`);
+    }
+    // Official docs: response has a "models" array (not "data")
+    // Each entry has: id, description, release_date (for aliases)
+    let raw;
+    try {
+        raw = await resp.json();
+    }
+    catch (e) {
+        throw new Error(`Failed to parse Jev models response as JSON: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    const entries = raw.models ?? raw.data ?? [];
+    if (!Array.isArray(entries)) {
+        throw new Error("Unexpected Jev models response shape — expected array");
+    }
+    return entries.map((m) => ({
+        id: m.id,
+        ...(m.description ? { description: m.description } : {}),
+        ...(m.release_date ? { release_date: m.release_date } : {}),
+        ...(m.aliases ? { aliases: m.aliases } : {}),
+    }));
+}
+// ─── MCP server ─────────────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "mcp-jev",
+    version: "1.0.0",
+});
+// ── Tool 1: jev_decide ──────────────────────────────────────────────────────
+/**
+ * QuestionSchema covers all three Jev primitives: noul, choice, score.
+ *
+ * Per official TypeSafe docs:
+ *   - instructions: string | object | array
+ *   - choice criteria values: string | object | array | null  (max 255 options)
+ *   - score criteria levels: string | object | array per level (2–10 levels)
+ *   - noul criteria: string (optional clarification only)
+ */
+const InstructionsSchema = z
+    .union([z.string(), z.record(z.unknown()), z.array(z.unknown())])
+    .describe([
+    "What the model should decide. Can be:",
+    "  - A plain string: \"Is `message` urgent?\"",
+    "  - An object: split the question and supporting data into named fields",
+    "  - An array: ordered list of instruction parts",
+    "Reference state fields with backtick paths, e.g. `message` or `order.id`.",
+].join("\n"));
+/** Value for a single Choice option or Score level — string, object, array, or null */
+const CriteriaValueSchema = z
+    .union([z.string(), z.record(z.unknown()), z.array(z.unknown()), z.null()])
+    .describe("Description for this option/level. Use null for options that need no extra detail.");
+const QuestionSchema = z.discriminatedUnion("type", [
+    z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe("Unique key for this question. Used to look up the answer in the response."),
+        type: z.literal("noul").describe("True/false probability question."),
+        instructions: InstructionsSchema,
+        criteria: z
+            .string()
+            .optional()
+            .describe("Optional extra clarification string for the model."),
+    }),
+    z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe("Unique key for this question. Used to look up the answer in the response."),
+        type: z.literal("choice").describe("Pick one from a named list of options."),
+        instructions: InstructionsSchema,
+        criteria: z
+            .record(CriteriaValueSchema)
+            .refine((obj) => Object.keys(obj).length <= 255, {
+            message: "Choice criteria cannot exceed 255 options",
+        })
+            .describe([
+            "Map of option key → description (max 255 options).",
+            "Each value can be: string, object (for multi-part guidance), array, or null.",
+            'Use null for options that need no extra detail, e.g. {"other": null}.',
+        ].join("\n")),
+    }),
+    z.object({
+        id: z
+            .string()
+            .min(1)
+            .describe("Unique key for this question. Used to look up the answer in the response."),
+        type: z.literal("score").describe("Rate on an ordered scale of 2–10 levels."),
+        instructions: InstructionsSchema,
+        criteria: z
+            .array(CriteriaValueSchema)
+            .min(2)
+            .max(10)
+            .describe([
+            "Ordered list of level descriptions from lowest to highest (2–10 levels).",
+            "Each level can be: string, object (for multi-part guidance), or array.",
+            'e.g. ["calm", "frustrated", "very angry"] or [{label:"calm", examples:[...]}]',
+        ].join("\n")),
+    }),
+]);
+server.tool("jev_decide", [
+    "Evaluate one or more typed questions against a state using TypeSafe Jev.",
+    "",
+    "All questions share the same state and are evaluated in parallel in a single API call.",
+    "Returns calibrated probabilities for each answer — not generated text.",
+    "",
+    "When to call:",
+    "  - Classify or route text (intent, category, department)",
+    "  - Check a true/false condition with calibrated confidence (is_urgent, is_spam)",
+    "  - Rate content on a rubric (severity, quality, sentiment)",
+    "  - Run multiple of the above on the same content in one call",
+    "",
+    "Question types:",
+    "  - noul: yes/no probability (0–1). instructions = string|object|array.",
+    "  - choice: pick one of N options. instructions + criteria values = string|object|array|null.",
+    "  - score: rate on ordered rubric. instructions + each level = string|object|array.",
+    "",
+    "instructions can be a plain string, an object (split question + supporting data), or an array.",
+    "criteria values can be a string, an object (multi-part guidance), an array, or null.",
+    "",
+    "Tip: send only the state fields each question needs. Extra context degrades accuracy.",
+].join("\n"), {
+    state: z
+        .union([
+        z.string(),
+        z.record(z.unknown()),
+        z.array(z.unknown()),
+    ])
+        .describe([
+        "The content Jev evaluates. Can be:",
+        "  - A plain string: \"My card was charged twice.\"",
+        "  - An object with named fields: {\"message\": \"...\", \"order_id\": \"A-104\"}",
+        "  - An array of records (for batches or conversation turns)",
+        "Include only what the questions need — extra content lowers accuracy.",
+    ].join("\n")),
+    questions: z
+        .array(QuestionSchema)
+        .min(1)
+        .describe([
+        "List of questions to evaluate. Each has:",
+        "  id          — key used in the response answers map",
+        "  type        — \"noul\" | \"choice\" | \"score\"",
+        "  instructions — full question text, may reference state fields in backticks",
+        "  criteria    — required for choice (object) and score (array); optional for noul",
+    ].join("\n")),
+    model: z
+        .string()
+        .default("jev-latest")
+        .describe("Model alias or versioned ID. Use \"jev-latest\" for stable, \"jev-preview\" for cutting edge. Call jev_list_models to see available IDs."),
+}, async ({ state, questions, model }) => {
+    // Build the questions object (Record<id, JevQuestion>) from the array
+    const questionsMap = {};
+    for (const q of questions) {
+        if (q.id in questionsMap) {
+            return {
+                content: [{ type: "text", text: `Error: duplicate question id '${q.id}' — each question must have a unique id` }],
+                isError: true,
+            };
+        }
+        if (q.type === "noul") {
+            questionsMap[q.id] = {
+                type: "noul",
+                instructions: q.instructions,
+                ...(q.criteria ? { criteria: q.criteria } : {}),
+            };
+        }
+        else if (q.type === "choice") {
+            questionsMap[q.id] = {
+                type: "choice",
+                instructions: q.instructions,
+                criteria: q.criteria,
+            };
+        }
+        else {
+            // score
+            questionsMap[q.id] = {
+                type: "score",
+                instructions: q.instructions,
+                criteria: q.criteria,
+            };
+        }
+    }
+    try {
+        const result = await callSystemOne({
+            model,
+            state,
+            questions: questionsMap,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        answers: result.answers,
+                        model: result.model,
+                        usage: result.usage,
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return {
+            content: [{ type: "text", text: `Error calling Jev API: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ── Tool 2: jev_list_models ─────────────────────────────────────────────────
+server.tool("jev_list_models", [
+    "List the Jev model IDs and aliases available on this API key.",
+    "",
+    "When to call:",
+    "  - Before pinning a versioned model ID (e.g. jev-1.13.0) in jev_decide",
+    "  - To check whether jev-preview is available on this account",
+    "  - To confirm which model version is currently behind jev-latest",
+].join("\n"), {}, async () => {
+    try {
+        const models = await listModels();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(models, null, 2),
+                },
+            ],
+        };
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        return {
+            content: [{ type: "text", text: `Error fetching models: ${message}` }],
+            isError: true,
+        };
+    }
+});
+// ─── Start ───────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "mcp-jev",
+  "version": "1.0.0",
+  "description": "MCP server for TypeSafe Jev — System One Model. Two tools: jev_decide (noul/choice/score) and jev_list_models.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-jev": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "prepare": "tsc"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "typesafe",
+    "jev",
+    "system-one",
+    "ai",
+    "decision-model",
+    "classification",
+    "routing"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/mcp-jev"
+  },
+  "homepage": "https://github.com/your-username/mcp-jev#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.16.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.3"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}