saju-mcp 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# Saju MCP Server
+
+An [MCP](https://modelcontextprotocol.io) (Model Context Protocol) server that
+wraps the **Saju API** — Korean Four Pillars of Destiny (사주팔자 / Bazi) — so
+MCP-capable clients (Claude Desktop, Cursor, and other MCP hosts) can compute
+and interpret Saju directly in a conversation.
+
+Backed by the live API at **https://saju-api.pages.dev** (10 languages:
+ko, en, ja, zh, es, pt-br, vi, id, hi, th).
+
+## Tools
+
+| Tool | Upstream endpoint | What it does |
+|------|-------------------|--------------|
+| `saju_calculate` | `POST /api/v1/calculate` | Four Pillars (stem+branch+hanja), five-element distribution, Day Master, zodiac, from a solar birthdate. |
+| `saju_interpret` | `POST /api/v1/interpret` | Full reading: Ten Gods (십신), hidden stems, Yongshin (용신), Daeun (대운), localized summaries. |
+| `saju_compatibility` | `POST /api/v1/compatibility` | Two-person 궁합 score (0–100) with breakdown (element balance, Day Master relation, branch harmony/clash). |
+| `saju_daily` | `GET /api/v1/daily` | Daily fortune snapshot (score + advice) for a Day Master and date. |
+
+## Prerequisites
+
+- Node.js **18+** (uses the built-in global `fetch`).
+- A **Saju API key**. The free tier is **100 requests/day, no credit card**.
+
+### Get a free API key
+
+```bash
+curl -X POST https://saju-api.pages.dev/api/v1/keys/create \
+  -H "Content-Type: application/json" \
+  -d '{"email":"you@example.com"}'
+```
+
+The response contains an `api_key` of the form `sajuapi_free_...`. Keep it
+secret — it is passed to the server via the `SAJU_API_KEY` environment variable,
+never hardcoded.
+
+## Install & build
+
+```bash
+npm install
+npm run build      # compiles src/index.ts -> dist/index.js
+```
+
+Quick local check (lists the 4 tools, then exits):
+
+```bash
+SAJU_API_KEY="sajuapi_free_xxx" npm start
+```
+
+## Register in Claude Desktop
+
+Edit your `claude_desktop_config.json`:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Add (use the **absolute path** to the built `dist/index.js`):
+
+```json
+{
+  "mcpServers": {
+    "saju": {
+      "command": "node",
+      "args": ["D:\\kunstudio-apps\\saju-mcp\\dist\\index.js"],
+      "env": {
+        "SAJU_API_KEY": "sajuapi_free_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. The four `saju_*` tools appear in the tools menu.
+
+> Other MCP hosts (Cursor, Windsurf, custom clients) use the same shape:
+> `command: "node"`, `args: ["<abs path>/dist/index.js"]`, and a
+> `SAJU_API_KEY` env var.
+
+## Environment variables
+
+| Variable | Required | Default | Notes |
+|----------|----------|---------|-------|
+| `SAJU_API_KEY` | yes (for real calls) | _(empty)_ | Your `sajuapi_*` key, sent as the `X-API-Key` header. Without it, every call returns `401 invalid_api_key`. |
+| `SAJU_API_BASE` | no | `https://saju-api.pages.dev` | Override the upstream base URL (e.g. for a staging deploy). |
+
+## Example tool inputs
+
+`saju_calculate` / `saju_interpret`:
+
+```json
+{ "year": 1990, "month": 5, "day": 15, "hour": 14, "gender": "M", "lang": "en" }
+```
+
+(`hour: -1` if the birth hour is unknown.)
+
+`saju_compatibility`:
+
+```json
+{
+  "person_a": { "year": 1990, "month": 5, "day": 15, "hour": 14, "gender": "M" },
+  "person_b": { "year": 1992, "month": 8, "day": 3,  "hour": 9,  "gender": "F" },
+  "lang": "en"
+}
+```
+
+`saju_daily` (Day Master from a prior calculate/interpret call):
+
+```json
+{ "day_master": "갑", "date": "2026-06-17", "lang": "en" }
+```
+
+## License
+
+Proprietary — KunStudio. Wraps the Saju API; subject to that API's terms.

package/dist/actor.js

@@ -0,0 +1,268 @@
+/**
+ * Saju MCP Server — Apify Actor entrypoint (Streamable HTTP transport).
+ * -------------------------------------------------------------------
+ * This is the *cloud / Apify Store* entrypoint. It exposes the SAME four
+ * Saju tools as the stdio server (src/index.ts) but over Streamable HTTP,
+ * wired into Apify's Standby web server, and charges per tool call using
+ * pay-per-event (PPE) billing.
+ *
+ * The original stdio MCP server (src/index.ts) is left completely untouched
+ * so the free npm / Claude Desktop path keeps working. This file is only
+ * used inside an Apify Actor container.
+ *
+ * Pattern is taken verbatim from Apify's official TypeScript MCP template
+ * (apify/actor-templates → templates/ts-mcp-empty/src/main.ts):
+ *   - Standby mode, web server listens on process.env.APIFY_CONTAINER_PORT
+ *   - Stateless Streamable HTTP transport (new server per POST /mcp)
+ *   - webServerMcpPath "/mcp" (see .actor/actor.json)
+ *   - Readiness probe on GET / with the x-apify-container-server-readiness-probe header
+ *   - Actor.charge({ eventName }) per tool call (events in .actor/pay_per_event.json)
+ *
+ * Auth to the upstream Saju API still comes from the SAJU_API_KEY env var,
+ * never hardcoded. On Apify it is set as an Actor environment variable / secret.
+ */
+import express from 'express';
+import cors from 'cors';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { z } from 'zod';
+import { Actor, log } from 'apify';
+// ---------------------------------------------------------------------------
+// Apify init (configures the Actor for its environment; must run at startup).
+// ---------------------------------------------------------------------------
+await Actor.init();
+// ---------------------------------------------------------------------------
+// Configuration (identical semantics to src/index.ts).
+// ---------------------------------------------------------------------------
+const API_BASE = process.env.SAJU_API_BASE ?? 'https://saju-api.pages.dev';
+const API_KEY = process.env.SAJU_API_KEY ?? '';
+// Single PPE event: charged once per successful tool call (price in
+// .actor/pay_per_event.json — the file is the source of truth, finalized
+// in the Apify Console Monetization step before publishing).
+const CHARGE_EVENT = 'tool-call';
+const SUPPORTED_LANGS = [
+    'ko', 'en', 'ja', 'zh', 'es', 'pt-br', 'vi', 'id', 'hi', 'th',
+];
+if (!API_KEY) {
+    log.warning('[saju-mcp] SAJU_API_KEY is not set. Every tool call will return 401 ' +
+        'invalid_api_key until you set it as an Actor environment variable. ' +
+        'Get a free key (100 req/day, no card) at ' +
+        'POST https://saju-api.pages.dev/api/v1/keys/create');
+}
+async function callApi(path, init = { method: 'GET' }) {
+    const headers = {
+        'Content-Type': 'application/json',
+        // Header name MUST be X-API-Key (see openapi.yaml securitySchemes).
+        'X-API-Key': API_KEY,
+    };
+    const res = await fetch(`${API_BASE}${path}`, {
+        method: init.method,
+        headers,
+        body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+    let body;
+    const text = await res.text();
+    try {
+        body = text ? JSON.parse(text) : {};
+    }
+    catch {
+        body = { error: 'non_json_response', raw: text.slice(0, 500) };
+    }
+    return { ok: res.ok, status: res.status, body };
+}
+function toToolResponse(result) {
+    if (!result.ok) {
+        const errObj = result.body;
+        const hint = result.status === 401
+            ? ' (set the SAJU_API_KEY Actor environment variable to a valid key — get a free one at POST /api/v1/keys/create)'
+            : result.status === 429
+                ? ' (daily quota for your tier exceeded)'
+                : '';
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `Saju API error ${result.status}: ${JSON.stringify(errObj)}${hint}`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.body, null, 2) },
+        ],
+        structuredContent: result.body,
+    };
+}
+// ---------------------------------------------------------------------------
+// Shared Zod shapes (mirrors openapi.yaml BirthRequest exactly).
+// ---------------------------------------------------------------------------
+const langField = z
+    .enum(SUPPORTED_LANGS)
+    .optional()
+    .describe('Output language (default ko). One of: ' + SUPPORTED_LANGS.join(', '));
+const birthShape = {
+    year: z.number().int().min(1920).max(2050)
+        .describe('Solar (Gregorian) birth year, 1920–2050'),
+    month: z.number().int().min(1).max(12).describe('Birth month, 1–12'),
+    day: z.number().int().min(1).max(31).describe('Birth day, 1–31'),
+    hour: z.number().int().min(-1).max(23)
+        .describe('Birth hour in 24h time (0–23). Use -1 if the hour is unknown.'),
+    gender: z.enum(['M', 'F'])
+        .describe("Gender: 'M' or 'F' (affects Daeun / luck-pillar direction)."),
+};
+const personSchema = z.object({
+    ...birthShape,
+    lang: langField,
+});
+// ---------------------------------------------------------------------------
+// Build a fresh McpServer with the four Saju tools registered.
+// A new instance is created per request (stateless Streamable HTTP).
+// ---------------------------------------------------------------------------
+function getServer() {
+    const server = new McpServer({ name: 'saju-mcp', version: '0.1.0' }, { capabilities: { logging: {} } });
+    // 1) saju_calculate — POST /api/v1/calculate
+    server.registerTool('saju_calculate', {
+        title: 'Calculate Saju (Four Pillars)',
+        description: 'Compute the Korean Four Pillars of Destiny (사주팔자 / Bazi) from a ' +
+            'solar birthdate. Returns the year/month/day/hour pillars (heavenly ' +
+            'stem + earthly branch, with hanja), the five-element distribution ' +
+            '(wood/fire/earth/metal/water), the Day Master, and the zodiac animal.',
+        inputSchema: { ...birthShape, lang: langField },
+    }, async (args) => {
+        await Actor.charge({ eventName: CHARGE_EVENT });
+        const result = await callApi('/api/v1/calculate', { method: 'POST', body: args });
+        return toToolResponse(result);
+    });
+    // 2) saju_interpret — POST /api/v1/interpret
+    server.registerTool('saju_interpret', {
+        title: 'Interpret Saju (Ten Gods, Yongshin, Daeun)',
+        description: 'Full Saju interpretation from a solar birthdate: the Four Pillars plus ' +
+            'Ten Gods (십신), hidden stems, life stages, interactions, Yongshin ' +
+            '(용신 / useful god), Daeun (대운 / luck pillars), and human-readable ' +
+            'summaries in the requested language.',
+        inputSchema: { ...birthShape, lang: langField },
+    }, async (args) => {
+        await Actor.charge({ eventName: CHARGE_EVENT });
+        const result = await callApi('/api/v1/interpret', { method: 'POST', body: args });
+        return toToolResponse(result);
+    });
+    // 3) saju_compatibility — POST /api/v1/compatibility
+    server.registerTool('saju_compatibility', {
+        title: 'Saju Compatibility (궁합)',
+        description: 'Score two-person compatibility (궁합) from 0–100 based on both ' +
+            "people's Saju. Returns the overall score and a breakdown " +
+            '(element balance, Day Master relation, branch harmony, branch clash) ' +
+            "plus each person's Day Master and zodiac.",
+        inputSchema: {
+            person_a: personSchema.describe('First person (birth details).'),
+            person_b: personSchema.describe('Second person (birth details).'),
+            lang: langField,
+        },
+    }, async (args) => {
+        await Actor.charge({ eventName: CHARGE_EVENT });
+        const result = await callApi('/api/v1/compatibility', { method: 'POST', body: args });
+        return toToolResponse(result);
+    });
+    // 4) saju_daily — GET /api/v1/daily
+    server.registerTool('saju_daily', {
+        title: 'Daily Fortune Snapshot',
+        description: 'Daily fortune snapshot (0–100 score + advice) for a given Day Master ' +
+            'and date. Provide the Day Master either as a Korean stem character ' +
+            '(갑, 을, 병, 정, 무, 기, 경, 신, 임, 계) or an English alias ' +
+            '(e.g. wood_yang, water_yin). The Day Master comes from a prior ' +
+            'saju_calculate / saju_interpret call (day_master.stem).',
+        inputSchema: {
+            day_master: z.string().min(1).describe('Day Master: Korean stem (갑..계) or English alias ' +
+                '(wood_yang, wood_yin, fire_yang, ... water_yin).'),
+            date: z.string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, 'Must be YYYY-MM-DD')
+                .optional()
+                .describe('Target date in YYYY-MM-DD. Defaults to today (UTC).'),
+            lang: langField,
+        },
+    }, async (args) => {
+        await Actor.charge({ eventName: CHARGE_EVENT });
+        const params = new URLSearchParams();
+        params.set('day_master', args.day_master);
+        if (args.date)
+            params.set('date', args.date);
+        if (args.lang)
+            params.set('lang', args.lang);
+        const result = await callApi(`/api/v1/daily?${params.toString()}`, { method: 'GET' });
+        return toToolResponse(result);
+    });
+    return server;
+}
+// ---------------------------------------------------------------------------
+// Express app wired into the Apify Standby web server.
+// ---------------------------------------------------------------------------
+const app = express();
+app.use(express.json());
+app.use(cors({
+    origin: '*',
+    exposedHeaders: ['Mcp-Session-Id'],
+}));
+// Readiness probe (Apify Standby health check).
+app.get('/', (req, res) => {
+    if (req.headers['x-apify-container-server-readiness-probe']) {
+        log.info('Readiness probe');
+        res.end('ok\n');
+        return;
+    }
+    res.status(404).end();
+});
+// MCP Streamable HTTP endpoint (matches webServerMcpPath in actor.json).
+app.post('/mcp', async (req, res) => {
+    const server = getServer();
+    try {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        res.on('close', () => {
+            transport.close();
+            server.close();
+        });
+    }
+    catch (error) {
+        log.error('Error handling MCP request', { error });
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: { code: -32603, message: 'Internal server error' },
+                id: null,
+            });
+        }
+    }
+});
+app.get('/mcp', (_req, res) => {
+    res.writeHead(405).end(JSON.stringify({
+        jsonrpc: '2.0',
+        error: { code: -32000, message: 'Method not allowed.' },
+        id: null,
+    }));
+});
+app.delete('/mcp', (_req, res) => {
+    res.writeHead(405).end(JSON.stringify({
+        jsonrpc: '2.0',
+        error: { code: -32000, message: 'Method not allowed.' },
+        id: null,
+    }));
+});
+const PORT = process.env.APIFY_CONTAINER_PORT
+    ? parseInt(process.env.APIFY_CONTAINER_PORT, 10)
+    : 3000;
+app.listen(PORT, (error) => {
+    if (error) {
+        log.error('Failed to start server', { error });
+        process.exit(1);
+    }
+    log.info(`Saju MCP Server (Apify) listening on port ${PORT} at path /mcp`);
+});
+process.on('SIGINT', () => {
+    log.info('Shutting down Saju MCP Actor...');
+    process.exit(0);
+});

package/dist/index.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+/**
+ * Saju MCP Server
+ * ---------------
+ * Exposes the live Saju API (https://saju-api.pages.dev) as Model Context
+ * Protocol tools over stdio, so MCP-capable clients (Claude Desktop, Cursor,
+ * etc.) can compute Korean Four Pillars (Saju / Bazi), daily fortune,
+ * compatibility, and full interpretation.
+ *
+ * SDK: @modelcontextprotocol/sdk v1.x (registerTool + StdioServerTransport).
+ *      inputSchema is a Zod RawShape (object of validators) per v1.x docs:
+ *      https://github.com/modelcontextprotocol/typescript-sdk/blob/v1.x/docs/server.md
+ *
+ * Auth: the upstream API requires an `X-API-Key` header. We read it from the
+ *       SAJU_API_KEY environment variable. NEVER hardcode a key here.
+ *       Get a free key (100 req/day, no card) at POST /api/v1/keys/create.
+ *
+ * Endpoint specs are taken verbatim from the live backend:
+ *   D:\saju-api\public\docs\openapi.yaml  and  D:\saju-api\functions\api\v1\*.js
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const API_BASE = process.env.SAJU_API_BASE ?? 'https://saju-api.pages.dev';
+const API_KEY = process.env.SAJU_API_KEY ?? '';
+const SUPPORTED_LANGS = [
+    'ko', 'en', 'ja', 'zh', 'es', 'pt-br', 'vi', 'id', 'hi', 'th',
+];
+async function callApi(path, init = { method: 'GET' }) {
+    const headers = {
+        'Content-Type': 'application/json',
+        // Header name MUST be X-API-Key (see openapi.yaml securitySchemes).
+        'X-API-Key': API_KEY,
+    };
+    const res = await fetch(`${API_BASE}${path}`, {
+        method: init.method,
+        headers,
+        body: init.body !== undefined ? JSON.stringify(init.body) : undefined,
+    });
+    let body;
+    const text = await res.text();
+    try {
+        body = text ? JSON.parse(text) : {};
+    }
+    catch {
+        body = { error: 'non_json_response', raw: text.slice(0, 500) };
+    }
+    return { ok: res.ok, status: res.status, body };
+}
+/** Format an ApiResult as an MCP tool response (text + structured content). */
+function toToolResponse(result) {
+    if (!result.ok) {
+        const errObj = result.body;
+        const hint = result.status === 401
+            ? ' (set the SAJU_API_KEY environment variable to a valid key — get a free one at POST /api/v1/keys/create)'
+            : result.status === 429
+                ? ' (daily quota for your tier exceeded)'
+                : '';
+        return {
+            isError: true,
+            content: [
+                {
+                    type: 'text',
+                    text: `Saju API error ${result.status}: ` +
+                        `${JSON.stringify(errObj)}${hint}`,
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            { type: 'text', text: JSON.stringify(result.body, null, 2) },
+        ],
+        structuredContent: result.body,
+    };
+}
+// ---------------------------------------------------------------------------
+// Shared Zod shapes (mirrors openapi.yaml BirthRequest exactly).
+// ---------------------------------------------------------------------------
+const langField = z
+    .enum(SUPPORTED_LANGS)
+    .optional()
+    .describe('Output language (default ko). One of: ' + SUPPORTED_LANGS.join(', '));
+// BirthRequest fields, matching the API validators in functions/api/v1/*.js.
+const birthShape = {
+    year: z
+        .number()
+        .int()
+        .min(1920)
+        .max(2050)
+        .describe('Solar (Gregorian) birth year, 1920–2050'),
+    month: z.number().int().min(1).max(12).describe('Birth month, 1–12'),
+    day: z.number().int().min(1).max(31).describe('Birth day, 1–31'),
+    hour: z
+        .number()
+        .int()
+        .min(-1)
+        .max(23)
+        .describe('Birth hour in 24h time (0–23). Use -1 if the hour is unknown.'),
+    gender: z
+        .enum(['M', 'F'])
+        .describe("Gender: 'M' or 'F' (affects Daeun / luck-pillar direction)."),
+};
+// A nested person object (used by compatibility), built from the same shape.
+const personSchema = z.object({
+    ...birthShape,
+    lang: langField,
+});
+// ---------------------------------------------------------------------------
+// Server + tools
+// ---------------------------------------------------------------------------
+const server = new McpServer({
+    name: 'saju-mcp',
+    version: '0.1.0',
+});
+// 1) saju_calculate — POST /api/v1/calculate
+server.registerTool('saju_calculate', {
+    title: 'Calculate Saju (Four Pillars)',
+    description: 'Compute the Korean Four Pillars of Destiny (사주팔자 / Bazi) from a ' +
+        'solar birthdate. Returns the year/month/day/hour pillars (heavenly ' +
+        'stem + earthly branch, with hanja), the five-element distribution ' +
+        '(wood/fire/earth/metal/water), the Day Master, and the zodiac animal.',
+    inputSchema: {
+        ...birthShape,
+        lang: langField,
+    },
+}, async (args) => {
+    const result = await callApi('/api/v1/calculate', {
+        method: 'POST',
+        body: args,
+    });
+    return toToolResponse(result);
+});
+// 2) saju_interpret — POST /api/v1/interpret
+server.registerTool('saju_interpret', {
+    title: 'Interpret Saju (Ten Gods, Yongshin, Daeun)',
+    description: 'Full Saju interpretation from a solar birthdate: the Four Pillars plus ' +
+        'Ten Gods (십신), hidden stems, life stages, interactions, Yongshin ' +
+        '(용신 / useful god), Daeun (대운 / luck pillars), and human-readable ' +
+        'summaries in the requested language.',
+    inputSchema: {
+        ...birthShape,
+        lang: langField,
+    },
+}, async (args) => {
+    const result = await callApi('/api/v1/interpret', {
+        method: 'POST',
+        body: args,
+    });
+    return toToolResponse(result);
+});
+// 3) saju_compatibility — POST /api/v1/compatibility
+server.registerTool('saju_compatibility', {
+    title: 'Saju Compatibility (궁합)',
+    description: 'Score two-person compatibility (궁합) from 0–100 based on both ' +
+        "people's Saju. Returns the overall score and a breakdown " +
+        '(element balance, Day Master relation, branch harmony, branch clash) ' +
+        'plus each person\'s Day Master and zodiac.',
+    inputSchema: {
+        person_a: personSchema.describe('First person (birth details).'),
+        person_b: personSchema.describe('Second person (birth details).'),
+        lang: langField,
+    },
+}, async (args) => {
+    const result = await callApi('/api/v1/compatibility', {
+        method: 'POST',
+        body: args,
+    });
+    return toToolResponse(result);
+});
+// 4) saju_daily — GET /api/v1/daily
+server.registerTool('saju_daily', {
+    title: "Daily Fortune Snapshot",
+    description: 'Daily fortune snapshot (0–100 score + advice) for a given Day Master ' +
+        'and date. Provide the Day Master either as a Korean stem character ' +
+        '(갑, 을, 병, 정, 무, 기, 경, 신, 임, 계) or an English alias ' +
+        '(e.g. wood_yang, water_yin). The Day Master comes from a prior ' +
+        'saju_calculate / saju_interpret call (day_master.stem).',
+    inputSchema: {
+        day_master: z
+            .string()
+            .min(1)
+            .describe('Day Master: Korean stem (갑..계) or English alias ' +
+            '(wood_yang, wood_yin, fire_yang, ... water_yin).'),
+        date: z
+            .string()
+            .regex(/^\d{4}-\d{2}-\d{2}$/, 'Must be YYYY-MM-DD')
+            .optional()
+            .describe('Target date in YYYY-MM-DD. Defaults to today (UTC).'),
+        lang: langField,
+    },
+}, async (args) => {
+    const params = new URLSearchParams();
+    params.set('day_master', args.day_master);
+    if (args.date)
+        params.set('date', args.date);
+    if (args.lang)
+        params.set('lang', args.lang);
+    const result = await callApi(`/api/v1/daily?${params.toString()}`, {
+        method: 'GET',
+    });
+    return toToolResponse(result);
+});
+// ---------------------------------------------------------------------------
+// Boot
+// ---------------------------------------------------------------------------
+async function main() {
+    if (!API_KEY) {
+        // Warn on stderr (stdout is reserved for the JSON-RPC stream).
+        process.stderr.write('[saju-mcp] WARNING: SAJU_API_KEY is not set. Every tool call will ' +
+            'return 401 invalid_api_key until you set it. Get a free key at ' +
+            'POST https://saju-api.pages.dev/api/v1/keys/create\n');
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('[saju-mcp] server connected over stdio\n');
+}
+main().catch((err) => {
+    process.stderr.write(`[saju-mcp] fatal: ${String(err)}\n`);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "saju-mcp",
+  "version": "0.1.0",
+  "description": "MCP server wrapping the Saju API (Korean Four Pillars / Bazi) — calculate, interpret, compatibility, daily fortune in 10 languages.",
+  "license": "LicenseRef-Proprietary",
+  "author": "KunStudio",
+  "type": "module",
+  "mcpName": "io.github.ghdejr11-beep/saju-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ghdejr11-beep/saju-mcp.git"
+  },
+  "homepage": "https://saju-api.pages.dev",
+  "bin": {
+    "saju-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "start:actor": "node dist/actor.js",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "apify": "^3.7.0",
+    "cors": "^2.8.5",
+    "express": "^5.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.13",
+    "@types/express": "^5.0.2",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}