gigai-tools-mcp 0.1.0 → 0.2.0

package/README.md

@@ -15,7 +15,7 @@ Claude Desktop (`claude_desktop_config.json`) or any MCP client:
   "mcpServers": {
     "gigai-tools": {
       "command": "npx",
-      "args": ["-y", "github:cbsshekhawat18-lab/gigai-tools-mcp"],
+      "args": ["-y", "gigai-tools-mcp"],
       "env": {
         "GIGAI_API_KEY": "gk_live_...",
         "GIGAI_MCP_OUT_DIR": "/path/where/results/go"
@@ -28,12 +28,14 @@ Claude Desktop (`claude_desktop_config.json`) or any MCP client:
 Claude Code:
 
 ```
-claude mcp add gigai-tools -e GIGAI_API_KEY=gk_live_... -- npx -y github:cbsshekhawat18-lab/gigai-tools-mcp
+claude mcp add gigai-tools -e GIGAI_API_KEY=gk_live_... -- npx -y 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.
+Every catalog engine becomes a tool - all of them, from `merge_pdf` and `ocr_pdf` to `detect_pii` and `generate_qr`, fetched from the live catalog at startup so new engines appear without updating this package. 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.
+
+Since 0.2.0 there is also `agent_plan`: give it a goal sentence ("shrink this photo to under 150 KB as WebP") and it returns ordered steps naming this server's own tools with ready-to-use options. It sends only file metadata (basename, type, size) - never contents - and is limited to 10 plans per day per account. When planning capacity is unavailable it says so and the agent simply picks tools from the list itself.
 
 ## Environment
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gigai-tools-mcp",
-  "version": "0.1.0",
+  "version": "0.2.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": {

package/server.mjs

@@ -16,7 +16,7 @@
  */
 
 import path from "node:path";
-import { mkdir } from "node:fs/promises";
+import { mkdir, stat } from "node:fs/promises";
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -68,16 +68,86 @@ function toMcpTool(engine) {
 
 const bySlug = new Map(catalog.map((e) => [e.slug.replaceAll("-", "_"), e]));
 
+/**
+ * agent_plan: goal sentence + optional local file paths -> a tool pipeline,
+ * planned by the API's free-tier model chain. Only file METADATA (basename,
+ * type, size) is sent - never contents. The returned steps reference the
+ * engine tools this server already exposes; the API may be capacity-limited,
+ * in which case the honest answer is "plan it yourself from the tool list".
+ */
+const AGENT_PLAN_TOOL = {
+  name: "agent_plan",
+  description:
+    "Plan a multi-step file-processing pipeline from a goal sentence " +
+    "(e.g. 'shrink this photo to under 150 KB as WebP'). Returns ordered steps " +
+    "naming this server's own tools with ready-to-use options. Sends only file " +
+    "metadata, never contents. Rate-limited (10 plans/day per account).",
+  inputSchema: {
+    type: "object",
+    properties: {
+      goal: { type: "string", description: "What should happen, in one sentence." },
+      files: { type: "array", items: { type: "string" }, description: "Local file path(s) the goal is about (optional; only name/size/type are sent)." },
+    },
+    required: ["goal"],
+  },
+};
+
+const EXT_MIME = {
+  ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".png": "image/png", ".webp": "image/webp",
+  ".gif": "image/gif", ".avif": "image/avif", ".pdf": "application/pdf", ".csv": "text/csv",
+  ".json": "application/json", ".txt": "text/plain", ".md": "text/markdown",
+  ".html": "text/html", ".yaml": "application/yaml", ".yml": "application/yaml",
+  ".js": "text/javascript", ".css": "text/css", ".svg": "image/svg+xml",
+  ".srt": "application/x-subrip", ".vtt": "text/vtt",
+};
+
+async function agentPlan(goal, files = []) {
+  const metas = [];
+  for (const p of files.slice(0, 10)) {
+    let size = 0;
+    try { size = (await stat(p)).size; } catch { /* metadata only; missing file stays size 0 */ }
+    metas.push({ name: path.basename(p), type: EXT_MIME[path.extname(p).toLowerCase()] ?? "application/octet-stream", size });
+  }
+  const compact = catalog.map((e) => ({ id: e.slug, desc: e.description, inputs: e.options_schema }));
+  const resp = await fetch(`${client.baseUrl}/agent/plan`, {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${process.env.GIGAI_API_KEY}` },
+    body: JSON.stringify({ goal, files: metas, catalogue: compact }),
+  });
+  const data = await resp.json().catch(() => null);
+  if (!resp.ok) {
+    const message = data?.detail?.error?.message ?? `HTTP ${resp.status}`;
+    return { content: [{ type: "text", text: `No plan - ${message}\nYou can plan manually: list_tools shows every engine and its options.` }], isError: true };
+  }
+  const steps = (data.plan?.steps ?? []).filter((s) => bySlug.has(String(s.toolId ?? "").replaceAll("-", "_")));
+  if (!steps.length) {
+    return { content: [{ type: "text", text: "The model returned no usable steps for this server's tools. Plan manually from the tool list." }], isError: true };
+  }
+  const lines = steps.map((s, i) =>
+    `${i + 1}. ${String(s.toolId).replaceAll("-", "_")} ${JSON.stringify(s.input ?? {})} - ${s.why ?? ""}`);
+  return {
+    content: [{
+      type: "text",
+      text: `Plan (via ${data.provider}):\n${lines.join("\n")}\n\nCall the listed tools in order, passing each step's options; feed each result into the next step's files.`,
+    }],
+  };
+}
+
 const server = new Server(
-  { name: "gigai-tools", version: "0.1.0" },
+  { name: "gigai-tools", version: "0.2.0" },
   { capabilities: { tools: {} } },
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: catalog.map(toMcpTool),
+  tools: [AGENT_PLAN_TOOL, ...catalog.map(toMcpTool)],
 }));
 
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name === "agent_plan") {
+    const { goal, files } = request.params.arguments ?? {};
+    if (!goal) return { content: [{ type: "text", text: "agent_plan needs a goal." }], isError: true };
+    return agentPlan(String(goal), Array.isArray(files) ? files : []);
+  }
   const engine = bySlug.get(request.params.name);
   if (!engine) {
     return { content: [{ type: "text", text: `Unknown tool '${request.params.name}'.` }], isError: true };