@pinn-ai/mcp 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# @pinn-ai/mcp
+
+Generate images and videos from AI assistants using [pinn.ai](https://pinn.ai).
+
+Works with Claude Desktop, Cursor, VS Code, and any MCP-compatible client.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "pinn": {
+      "command": "npx",
+      "args": ["-y", "@pinn-ai/mcp"]
+    }
+  }
+}
+```
+
+This opens a browser for OAuth login on first use.
+
+### With API Key (no browser)
+
+```json
+{
+  "mcpServers": {
+    "pinn": {
+      "command": "npx",
+      "args": ["-y", "@pinn-ai/mcp"],
+      "env": {
+        "PINN_API_KEY": "pk_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Get your API key at [pinn.ai/profile](https://pinn.ai/profile).
+
+### Cursor / VS Code
+
+These support remote MCP directly — just add the URL `https://pinn.ai/mcp` in settings.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `text2image` | Generate images from text prompts |
+| `image2image` | Edit/transform existing images |
+| `text2video` | Generate videos from text prompts |
+| `image2video` | Animate images into videos |
+| `list_models` | Browse available AI models |
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+/**
+ * @pinn/mcp — Pinn.ai MCP server client
+ *
+ * Wraps mcp-remote to connect Claude Desktop / Cursor / VS Code
+ * to pinn.ai's remote MCP server with zero config.
+ *
+ * Usage in claude_desktop_config.json:
+ *
+ *   Option A — OAuth login (opens browser):
+ *   {
+ *     "mcpServers": {
+ *       "pinn": { "command": "npx", "args": ["-y", "@pinn/mcp"] }
+ *     }
+ *   }
+ *
+ *   Option B — API key (no browser needed):
+ *   {
+ *     "mcpServers": {
+ *       "pinn": {
+ *         "command": "npx",
+ *         "args": ["-y", "@pinn/mcp"],
+ *         "env": { "PINN_API_KEY": "pk_your_key_here" }
+ *       }
+ *     }
+ *   }
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const MCP_URL = 'https://pinn.ai/mcp';
+
+// Resolve mcp-remote's proxy binary
+const mcpRemotePkg = require.resolve('mcp-remote/package.json');
+const proxyBin = path.join(path.dirname(mcpRemotePkg), 'dist', 'proxy.js');
+
+// Build args: URL + optional auth header + any extra CLI args
+const args = [proxyBin, MCP_URL];
+
+const apiKey = process.env.PINN_API_KEY;
+if (apiKey) {
+  args.push('--header', `Authorization:Bearer ${apiKey}`);
+}
+
+// Pass through any extra args (e.g. --transport)
+args.push(...process.argv.slice(2));
+
+const child = spawn(process.execPath, args, {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+child.on('exit', (code) => process.exit(code ?? 1));
+child.on('error', (err) => {
+  console.error('Failed to start mcp-remote:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pinn-ai/mcp",
+  "version": "1.0.0",
+  "description": "Pinn.ai MCP server — generate images & videos from Claude Desktop, Cursor, and VS Code",
+  "bin": {
+    "pinn-mcp": "bin/cli.js"
+  },
+  "keywords": ["mcp", "pinn", "ai", "image-generation", "claude", "cursor"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pinn-ai/mcp"
+  },
+  "homepage": "https://pinn.ai",
+  "dependencies": {
+    "mcp-remote": "^0.1.38"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}