@kolmopdf/mcp-server 1.0.0 → 1.0.2

package/packages/mcp-server/tests/unit/errors.test.ts

@@ -1,112 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  ERROR_SPECS,
-  KolmoPdfError,
-  errorFromApiBody,
-  isAutoRefunded,
-  toMcpErrorResult,
-} from "../../src/errors.js";
-
-describe("KolmoPdfError", () => {
-  it("uses the spec default message, status, and remediation", () => {
-    const err = new KolmoPdfError("invalid_api_key");
-    expect(err.errorCode).toBe("invalid_api_key");
-    expect(err.httpStatus).toBe(401);
-    expect(err.message).toBe("API key is missing or invalid.");
-    expect(err.remediation).toContain("api-keys");
-    expect(err.source).toBe("api");
-  });
-
-  it("allows overriding message, status, and point fields", () => {
-    const err = new KolmoPdfError("insufficient_points", {
-      message: "custom",
-      pointsRequired: 20,
-      currentPoints: 5,
-    });
-    expect(err.message).toBe("custom");
-    expect(err.pointsRequired).toBe(20);
-    expect(err.currentPoints).toBe(5);
-  });
-
-  it("falls back to a generic spec for unknown codes", () => {
-    const err = new KolmoPdfError("totally_made_up");
-    expect(err.message).toBe("Unknown error.");
-    expect(err.httpStatus).toBeNull();
-  });
-});
-
-describe("toMcpErrorResult", () => {
-  it("wraps a KolmoPdfError into the MCP error envelope", () => {
-    const result = toMcpErrorResult(
-      new KolmoPdfError("insufficient_points", { pointsRequired: 20, currentPoints: 5 }),
-    );
-    expect(result.isError).toBe(true);
-    const payload = JSON.parse(result.content[0]?.text ?? "");
-    expect(payload.error_code).toBe("insufficient_points");
-    expect(payload.http_status).toBe(402);
-    expect(payload.points_required).toBe(20);
-    expect(payload.current_points).toBe(5);
-    expect(payload.remediation).toContain("subscription");
-  });
-
-  it("coerces a plain Error into api_task_error", () => {
-    const result = toMcpErrorResult(new Error("boom"));
-    const payload = JSON.parse(result.content[0]?.text ?? "");
-    expect(payload.error_code).toBe("api_task_error");
-    expect(payload.message).toBe("boom");
-  });
-
-  it("omits point fields when not provided", () => {
-    const result = toMcpErrorResult(new KolmoPdfError("parse_error"));
-    const payload = JSON.parse(result.content[0]?.text ?? "");
-    expect(payload).not.toHaveProperty("points_required");
-    expect(payload).not.toHaveProperty("current_points");
-  });
-});
-
-describe("isAutoRefunded", () => {
-  it("flags server-refunded failure codes", () => {
-    expect(isAutoRefunded("parse_error")).toBe(true);
-    expect(isAutoRefunded("parse_timeout")).toBe(true);
-    expect(isAutoRefunded("task_creation_failed")).toBe(true);
-    expect(isAutoRefunded("parse_file_invalid")).toBe(true);
-  });
-
-  it("does not flag non-refunded codes", () => {
-    expect(isAutoRefunded("invalid_api_key")).toBe(false);
-    expect(isAutoRefunded("insufficient_points")).toBe(false);
-  });
-});
-
-describe("errorFromApiBody", () => {
-  it("maps a failure body with code + points", () => {
-    const err = errorFromApiBody(
-      {
-        error_code: "insufficient_points",
-        message: "Insufficient points",
-        points_required: 20,
-        current_points: 15,
-      },
-      402,
-    );
-    expect(err.errorCode).toBe("insufficient_points");
-    expect(err.httpStatus).toBe(402);
-    expect(err.pointsRequired).toBe(20);
-    expect(err.currentPoints).toBe(15);
-  });
-
-  it("defaults to api_task_error when no code is present", () => {
-    const err = errorFromApiBody({ message: "weird" });
-    expect(err.errorCode).toBe("api_task_error");
-  });
-});
-
-describe("ERROR_SPECS coverage", () => {
-  it("every spec has a non-empty message and remediation", () => {
-    for (const [code, spec] of Object.entries(ERROR_SPECS)) {
-      expect(spec.message, code).toBeTruthy();
-      expect(spec.remediation, code).toBeTruthy();
-      expect(["api", "client"]).toContain(spec.source);
-    }
-  });
-});

package/packages/mcp-server/tests/unit/estimate-cost.test.ts

@@ -1,28 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { buildRecommendation, estimateCredits } from "../../src/tools/estimate-cost.js";
-
-describe("estimateCredits", () => {
-  it("parse = pages × 2", () => {
-    expect(estimateCredits("parse", 15)).toBe(30);
-  });
-  it("parse_translate = pages × 3", () => {
-    expect(estimateCredits("parse_translate", 15)).toBe(45);
-  });
-  it("translate = pages × 2", () => {
-    expect(estimateCredits("translate", 8)).toBe(16);
-  });
-  it("convert = 1 regardless of pages", () => {
-    expect(estimateCredits("convert", 999)).toBe(1);
-  });
-});
-
-describe("buildRecommendation", () => {
-  it("reports sufficiency when no shortfall", () => {
-    expect(buildRecommendation(0)).toBe("Sufficient");
-  });
-  it("includes the top-up URL and shortfall when short", () => {
-    const rec = buildRecommendation(195);
-    expect(rec).toContain("subscription");
-    expect(rec).toContain("195");
-  });
-});

package/packages/mcp-server/tests/unit/polling.test.ts

@@ -1,24 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { RETRY_POLICY, backoffDelayMs, isRetryable } from "../../src/polling.js";
-
-describe("backoffDelayMs", () => {
-  it("grows exponentially from the base delay", () => {
-    expect(backoffDelayMs(1)).toBe(RETRY_POLICY.baseDelayMs);
-    expect(backoffDelayMs(2)).toBe(RETRY_POLICY.baseDelayMs * RETRY_POLICY.factor);
-    expect(backoffDelayMs(3)).toBe(RETRY_POLICY.baseDelayMs * RETRY_POLICY.factor ** 2);
-  });
-});
-
-describe("isRetryable", () => {
-  it("retries transient network error codes", () => {
-    expect(isRetryable({ code: "ECONNRESET" })).toBe(true);
-    expect(isRetryable({ code: "ETIMEDOUT" })).toBe(true);
-  });
-  it("retries 5xx", () => {
-    expect(isRetryable({ httpStatus: 502 })).toBe(true);
-  });
-  it("does not retry 4xx business errors", () => {
-    expect(isRetryable({ httpStatus: 400 })).toBe(false);
-    expect(isRetryable({ httpStatus: 402 })).toBe(false);
-  });
-});

package/packages/mcp-server/tsconfig.json

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

package/packages/mcp-server/tsup.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["esm", "cjs"],
-  dts: true,
-  clean: true,
-  sourcemap: true,
-  target: "node20",
-  banner: {
-    js: "#!/usr/bin/env node",
-  },
-});

package/packages/mcp-server/vitest.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    environment: "node",
-    include: ["tests/**/*.test.ts"],
-    coverage: {
-      provider: "v8",
-      include: ["src/**/*.ts"],
-      reporter: ["text", "lcov"],
-    },
-  },
-});

package/plugins/kolmopdf/.claude-plugin/plugin.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/claude-code-plugin.json",
-  "name": "kolmopdf",
-  "displayName": "KolmoPDF",
-  "description": "High-fidelity PDF to Markdown parsing, layout-preserving PDF translation, and Markdown→DOCX/HTML/PDF/LaTeX conversion. Handles formulas, tables, and multi-column layouts that the built-in Read tool struggles with.",
-  "version": "1.0.0",
-  "author": {
-    "name": "KomoAI LLC",
-    "email": "support@kolmopdf.com"
-  },
-  "homepage": "https://www.kolmopdf.com",
-  "repository": "https://github.com/kolmopdf/claude-plugin",
-  "license": "MIT",
-  "keywords": ["pdf", "markdown", "ocr", "translation", "latex", "research", "arxiv", "kolmopdf"],
-  "category": "document-processing"
-}

package/plugins/kolmopdf/.mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "kolmopdf": {
-      "command": "npx",
-      "args": ["-y", "@kolmopdf/mcp-server"],
-      "env": {
-        "KOLMOPDF_API_KEY": "${KOLMOPDF_API_KEY}"
-      }
-    }
-  }
-}

package/plugins/kolmopdf/README.md

@@ -1,28 +0,0 @@
-# KolmoPDF
-
-## Install
-
-| Client | Command |
-| --- | --- |
-| Claude Code | `/plugin marketplace add kolmopdf/claude-plugin` then `/plugin install kolmopdf@kolmopdf` |
-| Codex CLI | `cp -r codex-skill/kolmopdf ~/.codex/skills/` + add `[mcp_servers.kolmopdf]` to `~/.codex/config.toml` |
-| Cursor | `cp -r codex-skill/kolmopdf ~/.cursor/skills/` + add server to `~/.cursor/mcp.json` |
-| Claude Desktop | Add server to `claude_desktop_config.json` (MCP tools only, no skill auto-trigger) |
-
-## API key
-
-Create a key at https://www.kolmopdf.com/api-keys (requires Plus or Pro), then set `KOLMOPDF_API_KEY` in your environment.
-
-## Tools
-
-| Tool | Capability |
-| --- | --- |
-| `kolmopdf_parse_pdf` | PDF → Markdown (optional translation) |
-| `kolmopdf_translate_pdf` | Layout-preserving PDF translation |
-| `kolmopdf_convert_markdown` | Markdown → DOCX / HTML / PDF / LaTeX |
-| `kolmopdf_estimate_cost` | Pre-flight credit estimate |
-| `kolmopdf_check_balance` | Current credit balance |
-
-## License
-
-MIT

package/plugins/kolmopdf/commands/balance.md

@@ -1,6 +0,0 @@
----
-description: Show KolmoPDF account credit balance.
-allowed-tools: mcp__kolmopdf__kolmopdf_check_balance
----
-
-Call `kolmopdf_check_balance` and report the result in a single line: `KolmoPDF balance: <points> credits (key <masked>)`.

package/plugins/kolmopdf/commands/convert.md

@@ -1,14 +0,0 @@
----
-description: Convert Markdown to DOCX, HTML, PDF, or LaTeX (KolmoPDF).
-argument-hint: <markdown-or-zip-path> [--format word|docx|html|pdf|latex|tex]
-allowed-tools: mcp__kolmopdf__kolmopdf_convert_markdown, mcp__kolmopdf__kolmopdf_estimate_cost
----
-
-Convert the provided Markdown file (or ZIP archive containing markdown + images) to the target format. Steps:
-
-1. Parse arguments. Default `--format word`.
-2. Call `kolmopdf_estimate_cost` for operation `convert` (always 1 credit). Stop if insufficient.
-3. Call `kolmopdf_convert_markdown`.
-4. Report `output.output_path` to the user.
-
-Arguments: $ARGUMENTS

package/plugins/kolmopdf/commands/parse.md

@@ -1,14 +0,0 @@
----
-description: Parse a PDF to Markdown via KolmoPDF (handles formulas, tables, multi-column).
-argument-hint: <file-path> [--translate] [--target-lang zh|en|ja|ko|fr|de|es|ru]
-allowed-tools: mcp__kolmopdf__kolmopdf_parse_pdf, mcp__kolmopdf__kolmopdf_estimate_cost
----
-
-Parse the PDF at the provided path using KolmoPDF. Steps:
-
-1. Run `kolmopdf_estimate_cost` for operation `parse` (or `parse_translate` if `--translate` was passed) and report the cost. If `sufficient=false`, stop.
-2. If `--translate` was passed, set `enable_translation=true` and use the `--target-lang` value (default `zh`) with `output_options=["bilingual"]`.
-3. Call `kolmopdf_parse_pdf`.
-4. Report `output.markdown_path` and `preview` to the user.
-
-Arguments: $ARGUMENTS

package/plugins/kolmopdf/commands/translate.md

@@ -1,14 +0,0 @@
----
-description: Translate a PDF while preserving its original layout (KolmoPDF).
-argument-hint: <file-path> [--from <lang>] [--to <lang>] [--mode translated_only|side_by_side]
-allowed-tools: mcp__kolmopdf__kolmopdf_translate_pdf, mcp__kolmopdf__kolmopdf_estimate_cost
----
-
-Translate the PDF while preserving its layout. Steps:
-
-1. Parse the file path and flags from $ARGUMENTS. Defaults: `--from en`, `--to zh`, `--mode translated_only`.
-2. Call `kolmopdf_estimate_cost` for operation `translate`. Stop if insufficient.
-3. Call `kolmopdf_translate_pdf` with the parsed arguments.
-4. Report `output.translated_pdf_path` to the user.
-
-Arguments: $ARGUMENTS

package/plugins/kolmopdf/skills/kolmopdf/SKILL.md

@@ -1,108 +0,0 @@
----
-name: kolmopdf
-description: Use this skill ONLY when the user gives an explicit operational instruction to process a PDF or Markdown file. Specifically: (1) explicitly asks to parse/convert a PDF into Markdown, (2) explicitly asks for layout-preserving PDF translation to produce a new translated PDF, (3) explicitly asks to export/convert Markdown to DOCX/HTML/PDF/LaTeX, or (4) a combination of the above (e.g. "parse this PDF to Markdown, then translate it, then export to DOCX"). Do NOT trigger for general PDF reading, summarization, or Q&A unless the user explicitly requests Markdown extraction first. Triggers: "parse PDF to markdown", "convert PDF to markdown", "translate this PDF preserving layout", "export markdown to docx/html/pdf/latex", "PDF to markdown with tables as images", "parse and translate this PDF".
-allowed-tools: mcp__kolmopdf__kolmopdf_parse_pdf, mcp__kolmopdf__kolmopdf_translate_pdf, mcp__kolmopdf__kolmopdf_convert_markdown, mcp__kolmopdf__kolmopdf_estimate_cost, mcp__kolmopdf__kolmopdf_check_balance, Read, Write
----
-
-# KolmoPDF Skill
-
-You have access to KolmoPDF tools (prefix `kolmopdf_*`) for high-fidelity PDF parsing and translation. These tools call a paid cloud service. Always follow the rules below.
-
-## When to use
-
-This skill triggers ONLY on explicit user instructions to perform a file operation:
-
-- User explicitly asks to parse/convert a PDF into Markdown → `kolmopdf_parse_pdf`.
-- User explicitly asks for layout-preserving PDF translation → `kolmopdf_translate_pdf`.
-- User explicitly asks to export Markdown to DOCX/HTML/PDF/LaTeX → `kolmopdf_convert_markdown`.
-- User requests a combination (e.g. "parse this PDF, translate it, then export to DOCX") → chain the tools in sequence.
-
-Do NOT trigger when:
-- User just wants to read or summarize a PDF without requesting Markdown output.
-- User asks general questions about a PDF's content (use built-in Read instead).
-- User mentions PDF in passing without an explicit processing instruction.
-
-## Natural language parameter mapping
-
-Users may describe parameters in natural language. Map their descriptions to tool parameters:
-
-| User says | Parameter |
-| --- | --- |
-| "tables as images" / "keep table layout" | `table_mode="image"` |
-| "use dollar signs for formulas" / "KaTeX format" | `formula_format="dollar"` |
-| "use bracket notation" / "LaTeX-style delimiters" | `formula_format="bracket"` |
-| "translate to Chinese/Japanese/..." | `enable_translation=true`, `target_language="zh"/"ja"/...` |
-| "bilingual output" / "show both languages" | `output_options=["bilingual"]` |
-| "images as URLs" / "don't download images" | `images_as_url=true` |
-| "merge tables across pages" / "cross-page tables" | `enable_cross_page_merge=true` |
-| "side by side translation" | `layout_modes=["side_by_side"]` |
-| "translate images too" | `enable_image_translation=true` |
-| "translate tables too" | `enable_table_translation=true` |
-| "export to Word/DOCX/HTML/PDF/LaTeX" | `target_format` accordingly |
-
-When the user's natural language is ambiguous, use sensible defaults from `references/parameter-glossary.md`. When the user specifies multiple preferences in one request, combine all applicable parameters in a single tool call.
-
-## Cost-awareness protocol
-
-Before running any operation that consumes credits:
-
-1. Call `kolmopdf_estimate_cost` with the file path and intended operation.
-2. If `sufficient` is false: stop and report `shortfall` and the top-up URL `https://www.kolmopdf.com/subscription` to the user. Do not proceed.
-3. If `estimated_credits > 50`: tell the user the estimated cost and ask for confirmation before proceeding.
-4. Otherwise: proceed.
-
-## API key requirement
-
-Tools require `KOLMOPDF_API_KEY` in the MCP server environment. If a tool returns `invalid_api_key`:
-
-- Direct the user to https://www.kolmopdf.com/api-keys to create a key (requires Plus or Pro plan).
-- Tell the user to set `KOLMOPDF_API_KEY` in their environment and restart Claude Code.
-- Do not proceed with retries until the user confirms.
-
-## Chained workflows
-
-### PDF → DOCX/HTML/PDF/LaTeX (full pipeline)
-
-1. `kolmopdf_estimate_cost(file, "parse")` → check balance.
-2. `kolmopdf_parse_pdf(file)` → get `markdown_path`.
-3. `kolmopdf_convert_markdown(markdown_path, target_format)` → final file.
-
-If the PDF contains many images, pass the original directory (not just the markdown file) by zipping `output_root` first using your own tools, then pass the zip to convert. See `references/chain-recipes.md`.
-
-### Read + ask Q&A about a paper
-
-1. `kolmopdf_parse_pdf(file)` → get `markdown_path` and `preview`.
-2. Use `Read` on `markdown_path` to load the full content.
-3. Answer the user's question grounded in the markdown.
-
-### Translate then convert to bilingual deliverable
-
-Option A (PDF deliverable):
-- `kolmopdf_translate_pdf(file, layout_modes=["side_by_side"])` → single PDF with side-by-side layout.
-
-Option B (editable Markdown deliverable):
-- `kolmopdf_parse_pdf(file, enable_translation=true, output_options=["bilingual"])` → bilingual markdown.
-
-## Parameter guidance
-
-See `references/parameter-glossary.md` for the full parameter table and defaults. Highlights:
-
-- `formula_format=dollar` is the default and works with KaTeX/MathJax. Use `bracket` for LaTeX-strict downstream renderers.
-- `enable_cross_page_merge=true` is recommended when the source PDF has tables spanning page breaks.
-- `images_as_url=true` returns a single markdown file with 30-day URL references; use this for ephemeral pipelines. Default `false` returns a self-contained ZIP.
-
-## Output handling
-
-After successful tool calls, treat `output.markdown_path` / `output.translated_pdf_path` / `output.output_path` as the canonical local file paths and reference them in your reply to the user. Show the user the absolute path; do not re-print the entire file unless asked.
-
-## Failure modes
-
-| error_code | Action |
-| --- | --- |
-| `invalid_api_key` | Stop; follow API key requirement section above. |
-| `insufficient_points` | Stop; report shortfall and top-up URL. |
-| `parse_page_limit_exceeded`, `parse_file_too_large` | Stop; suggest splitting the PDF locally. |
-| `parse_file_not_pdf`, `parse_file_invalid` | Stop; ask the user to re-export the PDF. |
-| `parse_error`, `parse_timeout` | Server auto-refunds points. Suggest retry with smaller page range. |
-| `client_polling_timeout` | Tell the user the task is still running server-side and suggest using `kolmopdf_get_task_status` with the task_id later. |
-| Network/5xx | Tools auto-retry up to 3 times. If still failing, suggest checking https://www.kolmopdf.com/contact. |

package/plugins/kolmopdf/skills/kolmopdf/references/chain-recipes.md

@@ -1,35 +0,0 @@
-# KolmoPDF Chain Recipes
-
-Expanded, step-by-step playbooks for the chained workflows summarized in `SKILL.md`.
-
-## Recipe 1 — PDF → DOCX/HTML/PDF/LaTeX (full pipeline)
-
-1. `kolmopdf_estimate_cost({ file_path, operation: "parse" })`.
-   - If `sufficient=false` → stop; report `shortfall` + https://www.kolmopdf.com/subscription.
-   - If `estimated_credits > 50` → ask the user to confirm.
-2. `kolmopdf_parse_pdf({ file_path })` → capture `output.markdown_path` and `output.output_root`.
-3. Decide the convert input:
-   - **Markdown has no local images** (or `images_as_url=true` was used): pass `output.markdown_path` directly.
-   - **Markdown references local images**: zip `output.output_root` with your own tools (`Write`/shell), then pass the `.zip` path so figures survive conversion.
-4. `kolmopdf_convert_markdown({ file_path: <md-or-zip>, target_format })`.
-5. Report `output.output_path` to the user (absolute path).
-
-Total cost ≈ `pages × 2 + 1`.
-
-## Recipe 2 — Read + Q&A about a paper
-
-1. `kolmopdf_parse_pdf({ file_path })` → `output.markdown_path`, `preview`.
-2. `Read` the `markdown_path` to load full content into context.
-3. Answer the user's question grounded strictly in the parsed markdown. Cite section headings where useful.
-
-## Recipe 3 — Translate then deliver bilingual
-
-**Option A — PDF deliverable (layout preserved):**
-1. `kolmopdf_estimate_cost({ file_path, operation: "translate" })`.
-2. `kolmopdf_translate_pdf({ file_path, source_language, target_language, layout_modes: ["side_by_side"] })`.
-3. Report `output.translated_pdf_path`.
-
-**Option B — editable Markdown deliverable:**
-1. `kolmopdf_estimate_cost({ file_path, operation: "parse_translate" })`.
-2. `kolmopdf_parse_pdf({ file_path, enable_translation: true, target_language, output_options: ["bilingual"] })`.
-3. Report `output.markdown_path`. Optionally chain Recipe 1 step 4 to produce a bilingual DOCX.

package/plugins/kolmopdf/skills/kolmopdf/references/parameter-glossary.md

@@ -1,72 +0,0 @@
-# KolmoPDF Parameter Glossary
-
-Full parameter reference for the KolmoPDF tools. This file is not auto-loaded; the skill reads it on demand.
-
-## `kolmopdf_parse_pdf`
-
-| Parameter | Type | Legal values | Default | Billing impact |
-| --- | --- | --- | --- | --- |
-| `file_path` | string | local path to a `.pdf` | — | — |
-| `table_mode` | enum | `markdown`, `image` | `markdown` | none |
-| `formula_format` | enum | `dollar`, `bracket` | `dollar` | none |
-| `enable_translation` | boolean | `true`, `false` | `false` | `true` → 3 pts/page instead of 2 |
-| `target_language` | enum | `zh`, `en`, `ja`, `ko`, `fr`, `de`, `es`, `ru` | `zh` | only when `enable_translation=true` |
-| `output_options` | string[] | `original`, `translated`, `bilingual` | `original` | none |
-| `images_as_url` | boolean | `true`, `false` | `false` | none (`true` → single `.md` w/ 30-day URLs; `false` → ZIP) |
-| `skip_rotation_detection` | boolean | `true`, `false` | `false` | none |
-| `enable_cross_page_merge` | boolean | `true`, `false` | `false` | none (merges tables across ≤ 3 pages) |
-| `output_subdir` | string | any dir name | `<task_id>` | none |
-
-Cost: parse only = `pages × 2`; parse + translate = `pages × 3`.
-
-## `kolmopdf_translate_pdf`
-
-| Parameter | Type | Legal values | Default |
-| --- | --- | --- | --- |
-| `file_path` | string | local path to a `.pdf` | — |
-| `source_language` | string | language code | `en` |
-| `target_language` | string | language code | `zh` |
-| `layout_modes` | string[] | `translated_only`, `side_by_side` | `["translated_only"]` |
-| `enable_image_translation` | boolean | `true`, `false` | `false` |
-| `enable_table_translation` | boolean | `true`, `false` | `false` |
-| `output_subdir` | string | any dir name | `<task_id>` |
-
-Cost: `pages × 2`.
-
-## `kolmopdf_convert_markdown`
-
-| Parameter | Type | Legal values | Default |
-| --- | --- | --- | --- |
-| `file_path` | string | `.md`, `.markdown`, or `.zip` | — |
-| `target_format` | enum | `word`, `docx`, `html`, `pdf`, `latex`, `tex` | `word` |
-| `output_subdir` | string | any dir name | `<task_id>` |
-
-Extension mapping: `word|docx → .docx`, `html → .html`, `pdf → .pdf`, `latex|tex → .tex`.
-
-Cost: 1 credit/task.
-
-## Language codes
-
-| Code | Language |
-| --- | --- |
-| `zh` | Chinese |
-| `en` | English |
-| `ja` | Japanese |
-| `ko` | Korean |
-| `fr` | French |
-| `de` | German |
-| `es` | Spanish |
-| `ru` | Russian |
-
-## ZIP output structure (`images_as_url=false`)
-
-```
-<KOLMOPDF_OUTPUT_DIR>/<task_id>/
-├── <document>.md          # canonical markdown_path (first *.md found)
-├── images/                # extracted figures → images_dir
-│   ├── img-0001.png
-│   └── ...
-└── (other assets, flattened)
-```
-
-When `images_as_url=true`, the result is a single `result.md` with public image URLs (cached 30 days) and `images_dir = null`.

package/pnpm-workspace.yaml

@@ -1,2 +0,0 @@
-packages:
-  - "packages/*"

package/smithery.yaml

@@ -1,21 +0,0 @@
-startCommand:
-  type: stdio
-  configSchema:
-    type: object
-    required: [KOLMOPDF_API_KEY]
-    properties:
-      KOLMOPDF_API_KEY:
-        type: string
-        description: "Your KolmoPDF API key (get one at https://www.kolmopdf.com/api-keys)."
-      KOLMOPDF_BASE_URL:
-        type: string
-        default: "https://www.kolmopdf.com"
-  commandFunction: |
-    (config) => ({
-      command: "npx",
-      args: ["-y", "@kolmopdf/mcp-server"],
-      env: {
-        KOLMOPDF_API_KEY: config.KOLMOPDF_API_KEY,
-        KOLMOPDF_BASE_URL: config.KOLMOPDF_BASE_URL || "https://www.kolmopdf.com"
-      }
-    })

package/tsconfig.base.json

@@ -1,21 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "lib": ["ES2022"],
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-    "noFallthroughCasesInSwitch": true,
-    "esModuleInterop": true,
-    "forceConsistentCasingInFileNames": true,
-    "skipLibCheck": true,
-    "declaration": true,
-    "sourceMap": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true
-  }
-}