strovio-mcp 0.0.0-stage → 2.5.0

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# strovio-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[Model Context Protocol](https://modelcontextprotocol.io) server for [Strovio](https://strovio.xyz) file storage. It gives Claude Code, Claude Desktop, Cursor, Codex and other MCP clients five tools: `list_files`, `upload_file`, `get_file`, `file_exists` and `delete_file`. It runs locally over stdio and needs Node.js 18 or later.
+
+Full guide with every client and platform: https://strovio.xyz/docs/mcp (Markdown: https://strovio.xyz/docs/mcp.md)
+
+## Configure
+
+| Variable | Required | Notes |
+|---|---|---|
+| `STROVIO_API_KEY` | Yes | An `sk_live_` key from https://strovio.xyz/developer |
+| `STROVIO_API_URL` | No | Origin only. Defaults to `https://strovio.xyz`. |
+
+Claude Code (macOS and Linux):
+
+```bash
+claude mcp add strovio -e STROVIO_API_KEY=sk_live_... -- npx -y strovio-mcp
+```
+
+Any client with an `mcpServers` JSON file (Claude Desktop, Cursor):
+
+```json
+{
+  "mcpServers": {
+    "strovio": {
+      "command": "npx",
+      "args": ["-y", "strovio-mcp"],
+      "env": { "STROVIO_API_KEY": "sk_live_..." }
+    }
+  }
+}
+```
+
+Never commit a config file that contains the key.
+
+## Develop
+
+From the monorepo root:
+
+```bash
+yarn workspace strovio-sdk build
+yarn workspace strovio-mcp build
+STROVIO_API_KEY=sk_live_... node products/strovio/mcp/dist/index.js
+```
+
+For a local Strovio, set `STROVIO_API_URL=http://localhost:3000` and mint a key with `STROVIO_DEV_BOOTSTRAP=1 yarn strovio-bootstrap-key http://localhost:3000` (see `../web/README.md`).

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+
+// src/index.ts
+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 { StrovioClient, StrovioError } from "strovio-sdk";
+import { readFileSync } from "fs";
+import { extname } from "path";
+var MIME = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".pdf": "application/pdf",
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".json": "application/json",
+  ".txt": "text/plain",
+  ".zip": "application/zip"
+};
+function createClient() {
+  try {
+    return new StrovioClient();
+  } catch (err) {
+    process.stderr.write(
+      `${err.message}
+Set STROVIO_API_KEY in the MCP server's env block. STROVIO_API_URL is optional and defaults to https://strovio.xyz. Guide: https://strovio.xyz/docs/mcp
+`
+    );
+    process.exit(1);
+  }
+}
+var strovio = createClient();
+function errorText(err) {
+  if (err instanceof StrovioError && err.docUrl) {
+    return `Error: ${err.message} (${err.code}, see ${err.docUrl})`;
+  }
+  return `Error: ${err.message}`;
+}
+var server = new Server(
+  { name: "strovio", version: "2.5.0" },
+  { capabilities: { tools: {} } }
+);
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "list_files",
+      description: "List files stored in Strovio, newest first. Use this to find the exact key of a file before get_file or delete_file.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          prefix: { type: "string", description: "Only return files whose key contains this text, for example reports/" },
+          limit: { type: "number", description: "Maximum number of files to return, a whole number from 1 to 100" }
+        }
+      }
+    },
+    {
+      name: "upload_file",
+      description: "Upload a file from the machine running this MCP server into Strovio, up to 50 MiB. Uploading to an existing key replaces that file.",
+      inputSchema: {
+        type: "object",
+        required: ["filePath", "key"],
+        properties: {
+          filePath: { type: "string", description: "Absolute or relative path to the local file" },
+          key: { type: "string", description: "Path to store the file under, for example reports/q1.pdf. No leading slash, no .. segments." },
+          access: {
+            type: "string",
+            enum: ["public", "private"],
+            description: "public = anyone can access URL, private = presigned URL required (default: private)"
+          }
+        }
+      }
+    },
+    {
+      name: "get_file",
+      description: "Get metadata and a download URL for a file. Public files return a permanent URL; private files return a signed URL valid for one hour.",
+      inputSchema: {
+        type: "object",
+        required: ["key"],
+        properties: {
+          key: { type: "string", description: "The key returned by upload_file or list_files, or the path you uploaded to" }
+        }
+      }
+    },
+    {
+      name: "delete_file",
+      description: "Permanently delete a file from Strovio storage.",
+      inputSchema: {
+        type: "object",
+        required: ["key"],
+        properties: {
+          key: { type: "string", description: "The key returned by upload_file or list_files, or the path you uploaded to" }
+        }
+      }
+    },
+    {
+      name: "file_exists",
+      description: "Check whether a file exists in Strovio without downloading it.",
+      inputSchema: {
+        type: "object",
+        required: ["key"],
+        properties: {
+          key: { type: "string", description: "The key returned by upload_file or list_files, or the path you uploaded to" }
+        }
+      }
+    }
+  ]
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args = {} } = request.params;
+  try {
+    switch (name) {
+      case "list_files": {
+        const result = await strovio.list(args);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "upload_file": {
+        const { filePath, key, access } = args;
+        const buffer = readFileSync(filePath);
+        const contentType = MIME[extname(filePath).toLowerCase()] ?? "application/octet-stream";
+        const result = await strovio.upload(key, buffer, { contentType, access });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "get_file": {
+        const result = await strovio.get(args.key);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "delete_file": {
+        const result = await strovio.delete(args.key);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      case "file_exists": {
+        const result = await strovio.exists(args.key);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      }
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: errorText(err) }],
+      isError: true
+    };
+  }
+});
+var transport = new StdioServerTransport();
+await server.connect(transport);
+process.stderr.write("Strovio MCP server running\n");

package/package.json

@@ -1,6 +1,53 @@
 {
   "name": "strovio-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.5.0",
+  "description": "MCP server for Strovio file storage: lets Claude, Cursor, Codex and other MCP clients list, upload, get and delete files",
+  "homepage": "https://strovio.xyz/docs/mcp",
+  "bugs": {
+    "email": "support@strovio.xyz"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dormdeveloper/specvista-monorepo.git",
+    "directory": "products/strovio/mcp"
+  },
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "strovio-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "strovio-sdk": "^2.5.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "strovio",
+    "file-storage",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "codex"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}