mujvykaz-mcp 1.0.0

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,356 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+var API_KEY = process.env.MUJVYKAZ_API_KEY || process.env.CREWLOG_API_KEY;
+var BASE_URL = (process.env.MUJVYKAZ_BASE_URL || process.env.CREWLOG_BASE_URL || "https://app.mujvykaz.cz").replace(/\/$/, "");
+if (!API_KEY) {
+  console.error("MUJVYKAZ_API_KEY environment variable is required");
+  console.error("");
+  console.error("  1. Go to app.mujvykaz.cz \u2192 Settings \u2192 API kl\xED\u010De");
+  console.error("  2. Generate a personal API key");
+  console.error("  3. Set MUJVYKAZ_API_KEY=cl_your_key_here");
+  process.exit(1);
+}
+var CURRENCY_SCALE = { CZK: 1, EUR: 100 };
+function formatAmount(minorUnits, currency = "CZK") {
+  const value = minorUnits / CURRENCY_SCALE[currency];
+  if (currency === "CZK") return `${value.toLocaleString("cs-CZ")} K\u010D`;
+  return `${value.toLocaleString("cs-CZ", { minimumFractionDigits: 2, maximumFractionDigits: 2 })} \u20AC`;
+}
+async function api(path, options) {
+  const res = await fetch(`${BASE_URL}/api/v1${path}`, {
+    method: options?.method ?? "GET",
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json"
+    },
+    body: options?.body ? JSON.stringify(options.body) : void 0
+  });
+  if (!res.ok) {
+    const error = await res.json().catch(() => ({ error: res.statusText }));
+    throw new Error(`API error ${res.status}: ${JSON.stringify(error)}`);
+  }
+  const json = await res.json();
+  return json.data;
+}
+function formatDuration(minutes) {
+  const h = Math.floor(minutes / 60);
+  const m = minutes % 60;
+  if (h === 0) return `${m}m`;
+  if (m === 0) return `${h}h`;
+  return `${h}h ${m}m`;
+}
+var server = new McpServer({
+  name: "mujvykaz",
+  version: "1.0.0"
+});
+server.tool(
+  "my_profile",
+  "Zobrazit m\u016Fj profil \u2014 jm\xE9no, email, roli, pozici, hodinovou sazbu.",
+  {},
+  async () => {
+    const user = await api("/users/me");
+    return {
+      content: [{
+        type: "text",
+        text: `${user.name} (${user.email})
+Role: ${user.role}
+Pozice: ${user.position ?? "-"}
+Sazba: ${formatAmount(user.hourlyRate)}/h
+ID: ${user.id}`
+      }]
+    };
+  }
+);
+server.tool(
+  "my_stats",
+  "Zobrazit moje statistiky \u2014 hodiny a \u010D\xE1stky za tento t\xFDden a m\u011Bs\xEDc.",
+  {},
+  async () => {
+    const stats = await api("/users/me/stats");
+    return {
+      content: [{
+        type: "text",
+        text: `Tento t\xFDden: ${stats.thisWeek.totalHours}h \u2014 ${formatAmount(stats.thisWeek.totalAmount)} (${stats.thisWeek.entryCount} v\xFDkaz\u016F)
+Tento m\u011Bs\xEDc: ${stats.thisMonth.totalHours}h \u2014 ${formatAmount(stats.thisMonth.totalAmount)} (${stats.thisMonth.entryCount} v\xFDkaz\u016F)`
+      }]
+    };
+  }
+);
+server.tool(
+  "list_time_entries",
+  "Zobrazit v\xFDkazy pr\xE1ce s filtrov\xE1n\xEDm. Worker vid\xED jen sv\xE9, manager vid\xED sv\u016Fj t\xFDm, admin vid\xED v\u0161e.",
+  {
+    status: z.enum(["draft", "submitted", "approved", "invoiced"]).optional().describe("Filtr podle stavu"),
+    project_id: z.string().uuid().optional().describe("Filtr podle ID projektu"),
+    user_id: z.string().uuid().optional().describe("Filtr podle ID u\u017Eivatele"),
+    from: z.string().optional().describe("Od data (ISO 8601)"),
+    to: z.string().optional().describe("Do data (ISO 8601)"),
+    limit: z.number().min(1).max(500).optional().describe("Max po\u010Det z\xE1znam\u016F (v\xFDchoz\xED 100)")
+  },
+  async (params) => {
+    const query = new URLSearchParams();
+    if (params.status) query.set("status", params.status);
+    if (params.project_id) query.set("project_id", params.project_id);
+    if (params.user_id) query.set("user_id", params.user_id);
+    if (params.from) query.set("from", params.from);
+    if (params.to) query.set("to", params.to);
+    if (params.limit) query.set("limit", String(params.limit));
+    const entries = await api(`/time-entries?${query}`);
+    const text = entries.map((e) => `[${e.status}] ${e.description} \u2014 ${formatDuration(e.durationMinutes)} \u2014 ${formatAmount(e.amount)} (${e.project?.name ?? "bez projektu"}, ${e.user?.name ?? "?"}) ${new Date(e.startedAt).toLocaleDateString("cs-CZ")}`).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xE9 v\xFDkazy nenalezeny." }] };
+  }
+);
+server.tool(
+  "create_time_entry",
+  "Vytvo\u0159it nov\xFD v\xFDkaz pr\xE1ce.",
+  {
+    userId: z.string().uuid().describe("ID u\u017Eivatele"),
+    projectId: z.string().uuid().optional().describe("ID projektu"),
+    description: z.string().describe("Popis pr\xE1ce"),
+    startedAt: z.string().describe("Datum a \u010Das za\u010D\xE1tku (ISO 8601)"),
+    durationMinutes: z.number().min(1).describe("D\xE9lka v minut\xE1ch"),
+    hourlyRate: z.number().optional().describe("Hodinov\xE1 sazba"),
+    isBillable: z.boolean().optional().describe("Fakturovateln\xE9? (v\xFDchoz\xED true)")
+  },
+  async (params) => {
+    const entry = await api("/time-entries", { method: "POST", body: params });
+    return {
+      content: [{
+        type: "text",
+        text: `Vytvo\u0159en v\xFDkaz: "${entry.description}" \u2014 ${formatDuration(entry.durationMinutes)} \u2014 ${formatAmount(entry.amount)} (ID: ${entry.id})`
+      }]
+    };
+  }
+);
+server.tool(
+  "submit_time_entries",
+  "Odeslat v\xFDkazy ke schv\xE1len\xED (draft \u2192 submitted).",
+  { ids: z.array(z.string().uuid()).min(1).max(100).describe("ID v\xFDkaz\u016F k odesl\xE1n\xED") },
+  async (params) => {
+    const result = await api("/time-entries/bulk-status", { method: "PUT", body: { ids: params.ids, status: "submitted" } });
+    return { content: [{ type: "text", text: `Odesl\xE1no ${result.updated} v\xFDkaz\u016F ke schv\xE1len\xED.` }] };
+  }
+);
+server.tool(
+  "approve_time_entries",
+  "Schv\xE1lit v\xFDkazy (submitted \u2192 approved). Vy\u017Eaduje roli manager nebo admin.",
+  { ids: z.array(z.string().uuid()).min(1).max(100).describe("ID v\xFDkaz\u016F ke schv\xE1len\xED") },
+  async (params) => {
+    const result = await api("/time-entries/bulk-status", { method: "PUT", body: { ids: params.ids, status: "approved" } });
+    return { content: [{ type: "text", text: `Schv\xE1leno ${result.updated} v\xFDkaz\u016F.` }] };
+  }
+);
+server.tool(
+  "update_time_entry",
+  "Upravit v\xFDkaz pr\xE1ce.",
+  {
+    id: z.string().uuid().describe("ID v\xFDkazu"),
+    description: z.string().optional().describe("Nov\xFD popis"),
+    durationMinutes: z.number().min(1).optional().describe("Nov\xE1 d\xE9lka v minut\xE1ch"),
+    hourlyRate: z.number().min(0).optional().describe("Nov\xE1 hodinov\xE1 sazba"),
+    isBillable: z.boolean().optional().describe("Fakturovateln\xE9?"),
+    status: z.enum(["draft", "submitted", "approved", "invoiced"]).optional().describe("Nov\xFD stav"),
+    projectId: z.string().uuid().nullable().optional().describe("Nov\xE9 ID projektu")
+  },
+  async (params) => {
+    const { id, ...body } = params;
+    const entry = await api(`/time-entries/${id}`, { method: "PUT", body });
+    return {
+      content: [{
+        type: "text",
+        text: `V\xFDkaz upraven: "${entry.description}" \u2014 ${formatDuration(entry.durationMinutes)} \u2014 ${formatAmount(entry.amount)} [${entry.status}]`
+      }]
+    };
+  }
+);
+server.tool(
+  "delete_time_entry",
+  "Smazat v\xFDkaz pr\xE1ce.",
+  { id: z.string().uuid().describe("ID v\xFDkazu ke smaz\xE1n\xED") },
+  async (params) => {
+    await api(`/time-entries/${params.id}`, { method: "DELETE" });
+    return { content: [{ type: "text", text: `V\xFDkaz ${params.id} smaz\xE1n.` }] };
+  }
+);
+server.tool(
+  "list_projects",
+  "Zobrazit projekty s informacemi o rozpo\u010Dtu.",
+  {
+    status: z.enum(["active", "paused", "done", "archived"]).optional().describe("Filtr podle stavu"),
+    client_id: z.string().uuid().optional().describe("Filtr podle ID klienta")
+  },
+  async (params) => {
+    const query = new URLSearchParams();
+    if (params.status) query.set("status", params.status);
+    if (params.client_id) query.set("client_id", params.client_id);
+    const projects = await api(`/projects?${query}`);
+    const text = projects.map((p) => {
+      let budget = "";
+      if (p.budgetHoursPct !== null) budget += ` Hodiny: ${formatDuration(p.usedMinutes)}/${p.budgetHours}h (${p.budgetHoursPct}%)`;
+      if (p.budgetAmountPct !== null) budget += ` Rozpo\u010Det: ${formatAmount(p.usedAmount)}/${formatAmount(p.budgetAmount)} (${p.budgetAmountPct}%)`;
+      return `[${p.status}] ${p.name} (${p.client?.name ?? "?"}) \u2014 ${p.entryCount} v\xFDkaz\u016F${budget}`;
+    }).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xE9 projekty nenalezeny." }] };
+  }
+);
+server.tool(
+  "create_project",
+  "Vytvo\u0159it nov\xFD projekt. Vy\u017Eaduje roli admin.",
+  {
+    clientId: z.string().uuid().describe("ID klienta"),
+    name: z.string().describe("N\xE1zev projektu"),
+    description: z.string().optional().describe("Popis projektu"),
+    budgetHours: z.number().min(0).optional().describe("Rozpo\u010Det v hodin\xE1ch"),
+    budgetAmount: z.number().min(0).optional().describe("Rozpo\u010Det v K\u010D"),
+    hourlyRate: z.number().min(0).optional().describe("Hodinov\xE1 sazba projektu"),
+    deadline: z.string().optional().describe("Deadline (ISO 8601)")
+  },
+  async (params) => {
+    const project = await api("/projects", { method: "POST", body: params });
+    return { content: [{ type: "text", text: `Projekt vytvo\u0159en: "${project.name}" (ID: ${project.id})` }] };
+  }
+);
+server.tool(
+  "update_project",
+  "Upravit projekt. Vy\u017Eaduje roli admin.",
+  {
+    id: z.string().uuid().describe("ID projektu"),
+    name: z.string().optional().describe("Nov\xFD n\xE1zev"),
+    description: z.string().nullable().optional().describe("Nov\xFD popis"),
+    status: z.string().optional().describe("Nov\xFD stav (active/paused/done/archived)"),
+    budgetHours: z.number().min(0).nullable().optional().describe("Nov\xFD rozpo\u010Det v hodin\xE1ch"),
+    budgetAmount: z.number().min(0).nullable().optional().describe("Nov\xFD rozpo\u010Det v K\u010D"),
+    hourlyRate: z.number().min(0).nullable().optional().describe("Nov\xE1 hodinov\xE1 sazba"),
+    deadline: z.string().nullable().optional().describe("Nov\xFD deadline (ISO 8601)")
+  },
+  async (params) => {
+    const { id, ...body } = params;
+    const project = await api(`/projects/${id}`, { method: "PUT", body });
+    return { content: [{ type: "text", text: `Projekt upraven: "${project.name}" [${project.status}]` }] };
+  }
+);
+server.tool(
+  "list_clients",
+  "Zobrazit klienty a jejich projekty.",
+  {},
+  async () => {
+    const clients = await api("/clients");
+    const text = clients.map((c) => {
+      const projs = c.projects?.map((p) => `${p.name} [${p.status}]`).join(", ") ?? "\u017E\xE1dn\xE9 projekty";
+      return `${c.name} (${c.contactPerson ?? "?"}, ${c.contactEmail ?? "?"}) \u2014 ${projs}`;
+    }).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xED klienti nenalezeni." }] };
+  }
+);
+server.tool(
+  "create_client",
+  "Vytvo\u0159it nov\xE9ho klienta. Vy\u017Eaduje roli manager nebo admin.",
+  {
+    name: z.string().describe("N\xE1zev klienta"),
+    contactEmail: z.string().email().optional().describe("Kontaktn\xED email"),
+    contactPerson: z.string().optional().describe("Kontaktn\xED osoba"),
+    defaultHourlyRate: z.number().min(0).optional().describe("V\xFDchoz\xED hodinov\xE1 sazba")
+  },
+  async (params) => {
+    const client = await api("/clients", { method: "POST", body: params });
+    return { content: [{ type: "text", text: `Klient vytvo\u0159en: "${client.name}" (ID: ${client.id})` }] };
+  }
+);
+server.tool(
+  "update_client",
+  "Upravit klienta.",
+  {
+    id: z.string().uuid().describe("ID klienta"),
+    name: z.string().optional().describe("Nov\xFD n\xE1zev"),
+    contactEmail: z.string().email().nullable().optional().describe("Nov\xFD kontaktn\xED email"),
+    contactPerson: z.string().nullable().optional().describe("Nov\xE1 kontaktn\xED osoba"),
+    defaultHourlyRate: z.number().min(0).nullable().optional().describe("Nov\xE1 v\xFDchoz\xED sazba"),
+    isActive: z.boolean().optional().describe("Aktivn\xED?")
+  },
+  async (params) => {
+    const { id, ...body } = params;
+    const client = await api(`/clients/${id}`, { method: "PUT", body });
+    return { content: [{ type: "text", text: `Klient upraven: "${client.name}"` }] };
+  }
+);
+server.tool(
+  "list_invoices",
+  "Zobrazit faktury se stavy a \u010D\xE1stkami.",
+  {
+    status: z.enum(["draft", "sent", "paid"]).optional().describe("Filtr podle stavu faktury"),
+    client_id: z.string().uuid().optional().describe("Filtr podle ID klienta")
+  },
+  async (params) => {
+    const query = new URLSearchParams();
+    if (params.status) query.set("status", params.status);
+    if (params.client_id) query.set("client_id", params.client_id);
+    const invoices = await api(`/invoices?${query}`);
+    const text = invoices.map((inv) => `[${inv.status}] ${inv.number ?? "bez \u010D\xEDsla"} \u2014 ${inv.client?.name ?? "?"} \u2014 ${formatAmount(inv.totalAmount)} (vystaveno: ${inv.issuedAt ? new Date(inv.issuedAt).toLocaleDateString("cs-CZ") : "-"}, splatnost: ${inv.dueAt ? new Date(inv.dueAt).toLocaleDateString("cs-CZ") : "-"})`).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xE9 faktury nenalezeny." }] };
+  }
+);
+server.tool(
+  "list_users",
+  "Zobrazit \u010Dleny t\xFDmu s rolemi a sazbami.",
+  {},
+  async () => {
+    const users = await api("/users");
+    const text = users.map((u) => `${u.name} (${u.email}) \u2014 ${u.role} \u2014 ${formatAmount(u.hourlyRate)}/h${u.isActive ? "" : " [NEAKTIVN\xCD]"}`).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xED \u010Dlenov\xE9 t\xFDmu nenalezeni." }] };
+  }
+);
+server.tool(
+  "team_stats",
+  "Zobrazit statistiky t\xFDmu \u2014 hodiny a \u010D\xE1stky za tento m\u011Bs\xEDc. Vy\u017Eaduje roli manager+.",
+  {},
+  async () => {
+    const stats = await api("/users/stats");
+    const text = stats.map((s) => `${s.userName} (${s.role}) \u2014 ${s.thisMonth.totalHours}h \u2014 ${formatAmount(s.thisMonth.totalAmount)} (${s.thisMonth.entryCount} v\xFDkaz\u016F)`).join("\n");
+    return { content: [{ type: "text", text: text || "\u017D\xE1dn\xE9 statistiky." }] };
+  }
+);
+server.tool(
+  "query_reports",
+  "Zeptat se na data p\u0159irozen\xFDm jazykem. Vy\u017Eaduje roli manager+. P\u0159\xEDklady: 'Kolik hodin tento m\u011Bs\xEDc?', 'Top 5 projekt\u016F podle obratu'.",
+  { query: z.string().min(1).max(1e3).describe("Dotaz v \u010De\u0161tin\u011B nebo angli\u010Dtin\u011B") },
+  async (params) => {
+    const res = await fetch(`${BASE_URL}/api/v1/ai`, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${API_KEY}`, "Content-Type": "application/json" },
+      body: JSON.stringify({ query: params.query })
+    });
+    if (!res.ok) {
+      const error = await res.json().catch(() => ({ error: res.statusText }));
+      return { content: [{ type: "text", text: `Chyba: ${JSON.stringify(error)}` }] };
+    }
+    const json = await res.json();
+    const data = json.data;
+    let text = data.text ?? "\u017D\xE1dn\xE1 odpov\u011B\u010F";
+    if (data.data && data.data.length > 0) {
+      const rows = data.data;
+      const headers = Object.keys(rows[0]);
+      const table = [
+        headers.join(" | "),
+        headers.map(() => "---").join(" | "),
+        ...rows.map((row) => headers.map((h) => String(row[h] ?? "")).join(" | "))
+      ].join("\n");
+      text += `
+
+${table}`;
+    }
+    return { content: [{ type: "text", text }] };
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("M\u016Fj V\xFDkaz MCP Server v1.0.0 running on stdio");
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "mujvykaz-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Můj Výkaz — connect Claude to your timesheet data",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mujvykaz-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node18 --dts --clean",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "mcp",
+    "timesheet",
+    "claude",
+    "mujvykaz",
+    "evidence-prace"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pepino-nojgic/mujvykaz-mcp"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}