@teamflojo/floimg-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Flojo, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# @teamflojo/floimg-mcp
+
+Model Context Protocol (MCP) server for [FloImg](https://floimg.com) - AI image workflow automation.
+
+This package exposes FloImg's image generation, transformation, and saving capabilities to AI agents like Claude, GPT, and others through the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+## Installation
+
+```bash
+npm install -g @teamflojo/floimg-mcp
+# or
+pnpm add -g @teamflojo/floimg-mcp
+```
+
+## Usage
+
+### With Claude Desktop
+
+Add to your Claude Desktop configuration (`~/.claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "floimg": {
+      "command": "npx",
+      "args": ["-y", "@teamflojo/floimg-mcp"],
+      "env": {
+        "OPENAI_API_KEY": "sk-..."
+      }
+    }
+  }
+}
+```
+
+### With Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "floimg": {
+      "command": "npx",
+      "args": ["-y", "@teamflojo/floimg-mcp"]
+    }
+  }
+}
+```
+
+### Direct Execution
+
+```bash
+npx @teamflojo/floimg-mcp
+```
+
+## Available Tools
+
+### `generate_image`
+
+Generate any type of image with smart intent routing:
+
+- **AI Images**: DALL-E, Stability AI, Replicate
+- **Charts**: Bar, line, pie, radar (via QuickChart)
+- **Diagrams**: Flowcharts, sequence diagrams (via Mermaid)
+- **QR Codes**: Any URL or text
+- **Screenshots**: Capture any webpage
+- **Shapes**: SVG gradients and basic shapes
+
+```
+Intent: "golden retriever in a sunny field" → Routes to DALL-E
+Intent: "QR code for https://floimg.com" → Routes to QR generator
+Intent: "bar chart of sales data" → Routes to QuickChart
+```
+
+### `transform_image`
+
+Apply deterministic, pixel-precise transforms:
+
+- `resize` - Exact dimensions
+- `blur`, `sharpen` - Image effects
+- `grayscale`, `modulate` - Color adjustments
+- `addText`, `addCaption` - Text overlays
+- `roundCorners` - Border radius
+- `convert` - Format conversion (PNG, JPEG, WebP, AVIF)
+
+Unlike AI regeneration, these operations modify exactly what you specify.
+
+### `save_image`
+
+Save to filesystem or cloud storage:
+
+- `./output.png` → Local filesystem
+- `s3://bucket/key.png` → Amazon S3
+- `r2://bucket/key.png` → Cloudflare R2
+- `tigris://bucket/key.png` → Tigris
+
+### `run_pipeline`
+
+Execute multi-step workflows atomically:
+
+```json
+{
+  "steps": [
+    { "generate": { "intent": "mountain landscape at sunset" } },
+    { "transform": { "operation": "resize", "params": { "width": 1200, "height": 630 } } },
+    { "transform": { "operation": "addCaption", "params": { "text": "Adventure Awaits" } } },
+    { "save": { "destination": "s3://my-bucket/hero.png" } }
+  ]
+}
+```
+
+### `analyze_image`
+
+AI vision analysis with multiple providers:
+
+- OpenAI GPT-4V
+- Anthropic Claude Vision
+- Google Gemini Vision
+- Ollama LLaVA (local)
+
+### `generate_text`
+
+AI text generation for creating prompts, descriptions, and more.
+
+## Plugin Discovery
+
+The MCP server automatically discovers and loads installed FloImg plugins:
+
+- `@teamflojo/floimg-quickchart` - Chart generation
+- `@teamflojo/floimg-mermaid` - Diagram generation
+- `@teamflojo/floimg-qr` - QR code generation
+- `@teamflojo/floimg-d3` - Data visualization
+- `@teamflojo/floimg-screenshot` - Web screenshots
+- `@teamflojo/floimg-google` - Gemini AI providers
+
+Install plugins globally for the MCP server to find them:
+
+```bash
+npm install -g @teamflojo/floimg-quickchart @teamflojo/floimg-mermaid @teamflojo/floimg-qr
+```
+
+## Configuration
+
+Configure via environment variables or `floimg.config.ts`:
+
+```bash
+# AI Providers
+OPENAI_API_KEY=sk-...
+GOOGLE_AI_API_KEY=...
+ANTHROPIC_API_KEY=...
+
+# Cloud Storage
+AWS_ACCESS_KEY_ID=...
+AWS_SECRET_ACCESS_KEY=...
+AWS_REGION=us-east-1
+```
+
+## Requirements
+
+- Node.js 18+
+- `@teamflojo/floimg` (peer dependency)
+
+## Related
+
+- [FloImg Documentation](https://floimg.com/docs)
+- [FloImg Studio](https://studio.floimg.com) - Visual workflow builder
+- [Model Context Protocol](https://modelcontextprotocol.io/)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @teamflojo/floimg-mcp
+ *
+ * Model Context Protocol server for floimg - AI image workflow automation.
+ *
+ * This package provides an MCP server that exposes floimg's image generation,
+ * transformation, and saving capabilities to AI agents (Claude, GPT, etc.).
+ *
+ * ## Usage
+ *
+ * Add to your MCP configuration:
+ *
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "floimg": {
+ *       "command": "npx",
+ *       "args": ["-y", "@teamflojo/floimg-mcp"]
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * Or run directly:
+ *
+ * ```bash
+ * npx @teamflojo/floimg-mcp
+ * ```
+ *
+ * ## Available Tools
+ *
+ * - `generate_image` - Generate images (AI, charts, diagrams, QR codes, screenshots)
+ * - `transform_image` - Apply deterministic transforms (resize, blur, caption, etc.)
+ * - `save_image` - Save to filesystem or cloud storage (S3, R2, Tigris)
+ * - `run_pipeline` - Execute multi-step workflows atomically
+ * - `analyze_image` - AI vision analysis (GPT-4V, Claude, Gemini, Ollama)
+ * - `generate_text` - AI text generation
+ *
+ * @packageDocumentation
+ */
+export { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/index.js

@@ -0,0 +1,44 @@
+/**
+ * @teamflojo/floimg-mcp
+ *
+ * Model Context Protocol server for floimg - AI image workflow automation.
+ *
+ * This package provides an MCP server that exposes floimg's image generation,
+ * transformation, and saving capabilities to AI agents (Claude, GPT, etc.).
+ *
+ * ## Usage
+ *
+ * Add to your MCP configuration:
+ *
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "floimg": {
+ *       "command": "npx",
+ *       "args": ["-y", "@teamflojo/floimg-mcp"]
+ *     }
+ *   }
+ * }
+ * ```
+ *
+ * Or run directly:
+ *
+ * ```bash
+ * npx @teamflojo/floimg-mcp
+ * ```
+ *
+ * ## Available Tools
+ *
+ * - `generate_image` - Generate images (AI, charts, diagrams, QR codes, screenshots)
+ * - `transform_image` - Apply deterministic transforms (resize, blur, caption, etc.)
+ * - `save_image` - Save to filesystem or cloud storage (S3, R2, Tigris)
+ * - `run_pipeline` - Execute multi-step workflows atomically
+ * - `analyze_image` - AI vision analysis (GPT-4V, Claude, Gemini, Ollama)
+ * - `generate_text` - AI text generation
+ *
+ * @packageDocumentation
+ */
+// Re-export for programmatic usage (advanced)
+export { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH,8CAA8C;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}