@pipeworx/mcp-dicebear 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pipeworx
+
+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,32 @@
+# mcp-dicebear
+
+MCP server for generating avatars via [DiceBear API](https://www.dicebear.com). No authentication required.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `generate_avatar` | Generate a DiceBear avatar SVG URL for a given style and seed |
+| `list_styles` | List all available DiceBear avatar styles |
+
+## Quickstart via Pipeworx Gateway
+
+Call any tool through the hosted gateway with zero setup:
+
+```bash
+curl -X POST https://gateway.pipeworx.io/mcp \
+  -H "Content-Type: application/json" \
+  -d '{
+    "jsonrpc": "2.0",
+    "id": 1,
+    "method": "tools/call",
+    "params": {
+      "name": "dicebear_generate_avatar",
+      "arguments": { "style": "bottts", "seed": "hello" }
+    }
+  }'
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@pipeworx/mcp-dicebear",
+  "version": "1.0.0",
+  "description": "MCP server for generating avatars via DiceBear API",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "files": ["src"],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "dicebear", "avatars", "svg"],
+  "author": "Pipeworx <hello@pipeworx.io>",
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,110 @@
+/**
+ * DiceBear MCP — wraps DiceBear Avatar API v7 (free, no auth)
+ *
+ * Tools:
+ * - generate_avatar: Generate an avatar SVG URL for a given style and seed
+ * - list_styles: Return the list of available avatar styles
+ */
+
+interface McpToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+  };
+}
+
+interface McpToolExport {
+  tools: McpToolDefinition[];
+  callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+}
+
+const BASE_URL = 'https://api.dicebear.com/7.x';
+
+const STYLES = [
+  'adventurer',
+  'avataaars',
+  'bottts',
+  'fun-emoji',
+  'identicon',
+  'initials',
+  'lorelei',
+  'micah',
+  'miniavs',
+  'notionists',
+  'open-peeps',
+  'personas',
+  'pixel-art',
+  'thumbs',
+] as const;
+
+type Style = (typeof STYLES)[number];
+
+const tools: McpToolExport['tools'] = [
+  {
+    name: 'generate_avatar',
+    description:
+      'Generate a DiceBear avatar SVG URL for a given style and seed string. Returns the URL that renders the avatar inline.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        style: {
+          type: 'string',
+          description:
+            'The avatar style to use. Available styles: adventurer, avataaars, bottts, fun-emoji, identicon, initials, lorelei, micah, miniavs, notionists, open-peeps, personas, pixel-art, thumbs.',
+        },
+        seed: {
+          type: 'string',
+          description:
+            'A seed string that determines the avatar appearance. Same seed + style always produces the same avatar.',
+        },
+      },
+      required: ['style', 'seed'],
+    },
+  },
+  {
+    name: 'list_styles',
+    description: 'List all available DiceBear avatar styles.',
+    inputSchema: {
+      type: 'object',
+      properties: {},
+    },
+  },
+];
+
+async function callTool(name: string, args: Record<string, unknown>): Promise<unknown> {
+  switch (name) {
+    case 'generate_avatar':
+      return generateAvatar(args.style as string, args.seed as string);
+    case 'list_styles':
+      return listStyles();
+    default:
+      throw new Error(`Unknown tool: ${name}`);
+  }
+}
+
+function generateAvatar(style: string, seed: string) {
+  if (!STYLES.includes(style as Style)) {
+    throw new Error(
+      `Unknown style: "${style}". Available styles: ${STYLES.join(', ')}`
+    );
+  }
+  const url = `${BASE_URL}/${encodeURIComponent(style)}/svg?seed=${encodeURIComponent(seed)}`;
+  return {
+    style,
+    seed,
+    url,
+    format: 'svg',
+  };
+}
+
+function listStyles() {
+  return {
+    count: STYLES.length,
+    styles: [...STYLES],
+  };
+}
+
+export default { tools, callTool } satisfies McpToolExport;