gigai-tools-mcp 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# gigai-tools-mcp
+
+MCP server for the [GigAI Tools API](https://gigai.tools/developers). Gives AI agents (Claude Desktop, Claude Code, anything that speaks MCP) real file tools: merge PDFs, convert and compress images, extract PDF text, generate QR codes and more. The free plan gives 1,000 tasks a month.
+
+The tool list comes from the live API catalog at startup, so the server never offers a tool the API cannot run, and new engines appear without updating this package.
+
+## Setup
+
+Get an API key at [gigai.tools/developers](https://gigai.tools/developers) (free account, keys in the dashboard).
+
+Claude Desktop (`claude_desktop_config.json`) or any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "gigai-tools": {
+      "command": "npx",
+      "args": ["-y", "github:cbsshekhawat18-lab/gigai-tools-mcp"],
+      "env": {
+        "GIGAI_API_KEY": "gk_live_...",
+        "GIGAI_MCP_OUT_DIR": "/path/where/results/go"
+      }
+    }
+  }
+}
+```
+
+Claude Code:
+
+```
+claude mcp add gigai-tools -e GIGAI_API_KEY=gk_live_... -- npx -y github:cbsshekhawat18-lab/gigai-tools-mcp
+```
+
+## What the agent can do
+
+Every engine becomes a tool: `merge_pdf`, `split_pdf`, `rotate_pdf`, `pdf_to_text`, `convert_image`, `resize_image`, `compress_image`, `optimize_svg`, `markdown_to_html`, `generate_qr`. Tools take local file paths (or URLs the server fetches), and results are saved to `GIGAI_MCP_OUT_DIR` - file bytes never pass through the model's context, only the saved paths do.
+
+## Environment
+
+- `GIGAI_API_KEY` - required.
+- `GIGAI_API_BASE` - optional, defaults to the public API.
+- `GIGAI_MCP_OUT_DIR` - where results are saved (default: the working directory).
+
+## Privacy
+
+Files go to the GigAI API for processing. Contents are never logged, results are deleted after the retention window, and deletion is verified. Details: [gigai.tools/developers/docs](https://gigai.tools/developers/docs).

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "gigai-tools-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the GigAI Tools API - lets AI agents merge PDFs, convert images, generate QR codes and more. Free plan.",
+  "type": "module",
+  "bin": {
+    "gigai-mcp": "./server.mjs"
+  },
+  "files": [
+    "server.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "author": "Gigai Kripa Services <hello@gigaikripaservices.com>",
+  "homepage": "https://gigai.tools/developers",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "gigai-tools": "^0.1.0"
+  }
+}

package/server.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * gigai-mcp - MCP server for the GigAI Tools API (stdio transport).
+ *
+ * Exposes every engine from GET /v1/tools as an MCP tool, so agents can
+ * merge PDFs, convert images, generate QR codes and the rest. The tool list
+ * is fetched from the live catalog at startup: an engine the API cannot run
+ * is never offered, and new engines appear without a package update.
+ *
+ * Config (env): GIGAI_API_KEY (required), GIGAI_API_BASE (optional),
+ * GIGAI_MCP_OUT_DIR (where results are saved, default: the working dir).
+ *
+ * File handling: tools take local file PATHS. Results are saved to the out
+ * dir and the tool answer names the saved paths - file bytes never pass
+ * through the model's context.
+ */
+
+import path from "node:path";
+import { mkdir } from "node:fs/promises";
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { Client, GigaiError } from "gigai-tools";
+
+const OUT_DIR = process.env.GIGAI_MCP_OUT_DIR || process.cwd();
+
+let client;
+try {
+  client = new Client();
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+let catalog;
+try {
+  catalog = await client.tools();
+} catch (err) {
+  console.error(`Could not load the tool catalog from ${client.baseUrl}: ${err.message}`);
+  process.exit(1);
+}
+
+/** Engine manifest entry -> MCP tool definition (plain JSON Schema). */
+function toMcpTool(engine) {
+  const properties = { ...(engine.options_schema.properties ?? {}) };
+  const required = [...(engine.options_schema.required ?? [])];
+  if (!engine.no_input) {
+    properties.files = {
+      type: "array",
+      items: { type: "string" },
+      description: `Local ${engine.input_formats.join("/")} file path(s)` +
+        (engine.multi_input ? "" : " (exactly one)") +
+        ", or http(s) URLs the server fetches.",
+    };
+    required.unshift("files");
+  }
+  properties.output_dir = {
+    type: "string",
+    description: `Directory to save results into (default: ${OUT_DIR}).`,
+  };
+  return {
+    name: engine.slug.replaceAll("-", "_"),
+    description: `${engine.description} Output: ${engine.output_formats.join("/")}.`,
+    inputSchema: { type: "object", properties, required },
+  };
+}
+
+const bySlug = new Map(catalog.map((e) => [e.slug.replaceAll("-", "_"), e]));
+
+const server = new Server(
+  { name: "gigai-tools", version: "0.1.0" },
+  { capabilities: { tools: {} } },
+);
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: catalog.map(toMcpTool),
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const engine = bySlug.get(request.params.name);
+  if (!engine) {
+    return { content: [{ type: "text", text: `Unknown tool '${request.params.name}'.` }], isError: true };
+  }
+  const { files, output_dir: outputDir, ...options } = request.params.arguments ?? {};
+  const out = outputDir || OUT_DIR;
+  try {
+    await mkdir(out, { recursive: true });
+    const saved = await client.run(engine.slug, {
+      files: engine.no_input ? undefined : files,
+      options,
+      output: out,
+    });
+    const lines = saved.map((p) => path.resolve(p));
+    return {
+      content: [{
+        type: "text",
+        text: `Done. Saved:\n${lines.join("\n")}\n\nFiles were processed by the GigAI API and the server copies are deleted after the retention window.`,
+      }],
+    };
+  } catch (err) {
+    const message = err instanceof GigaiError
+      ? `${err.code}: ${err.apiMessage}${err.param ? ` (${err.param})` : ""}`
+      : err.message;
+    return { content: [{ type: "text", text: `Failed - ${message}` }], isError: true };
+  }
+});
+
+await server.connect(new StdioServerTransport());
+console.error(`gigai-mcp up: ${catalog.length} tools from ${client.baseUrl}, saving to ${OUT_DIR}`);