@promptforge/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,84 @@
+# PromptForge MCP Server
+
+Search and retrieve AI prompts from [PromptForge](https://promptforge-rose.vercel.app) using any MCP-compatible client — Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, opencode, and more.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_prompts` | Search prompts by keyword, model, or category with pagination |
+| `get_prompt` | Retrieve a full prompt by ID with content and metadata |
+| `list_categories` | Browse all available categories |
+| `get_trending` | Get currently trending prompts |
+
+## Installation
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "promptforge": {
+      "command": "npx",
+      "args": ["@promptforge/mcp-server"]
+    }
+  }
+}
+```
+
+### opencode
+
+Add to your `opencode.json`:
+
+```json
+{
+  "mcpServers": {
+    "promptforge": {
+      "command": "npx",
+      "args": ["@promptforge/mcp-server"]
+    }
+  }
+}
+```
+
+### VS Code / Cursor
+
+```json
+{
+  "mcpServers": {
+    "promptforge": {
+      "command": "npx",
+      "args": ["@promptforge/mcp-server"]
+    }
+  }
+}
+```
+
+### Run directly
+
+```bash
+npx @promptforge/mcp-server
+```
+
+## Usage Examples
+
+Once connected, ask your AI assistant:
+
+- *"Search PromptForge for prompts about React hooks"*
+- *"Find trending ChatGPT prompts for copywriting"*
+- *"Get the prompt with ID abc-123 and show me the full content"*
+- *"What categories are available on PromptForge?"*
+
+## Development
+
+```bash
+cd mcp-server
+npm install
+node index.js
+```
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const BASE_URL = process.env.PROMPT_FORGE_URL || "https://promptforge-rose.vercel.app";
+
+const server = new Server(
+  { name: "promptforge-mcp", version: "1.0.0" },
+  { capabilities: { tools: {} } }
+);
+
+async function fetchApi(path) {
+  const res = await fetch(`${BASE_URL}${path}`);
+  if (!res.ok) throw new Error(`API error: ${res.status}`);
+  return res.json();
+}
+
+function formatPrompt(p) {
+  const stats = p.stats || {};
+  const author = p.author || {};
+  const category = p.category || null;
+  return {
+    id: p.id,
+    title: p.title,
+    description: p.description || "",
+    model: p.model || "any",
+    author: author.displayName || author.username || "anonymous",
+    category: category?.name || null,
+    tags: (p.tags || []).map((t) => t.name),
+    stats: {
+      upvotes: stats.upvotes || 0,
+      saves: stats.saves || 0,
+      views: stats.views || 0,
+    },
+    url: `${BASE_URL}/prompts/${p.id}`,
+    created: p.createdAt,
+  };
+}
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "search_prompts",
+      description: "Search the PromptForge library for AI prompts by keyword, model, or category",
+      inputSchema: {
+        type: "object",
+        properties: {
+          q: { type: "string", description: "Search query (keyword, topic, or use case)" },
+          model: { type: "string", description: "Filter by AI model: chatgpt, claude, gemini, midjourney, dall-e, gpt-4" },
+          category: { type: "string", description: "Filter by category slug: coding, seo, marketing, copywriting, etc." },
+          sort: { type: "string", enum: ["trending", "newest", "most-upvoted", "most-saved"], default: "trending" },
+          limit: { type: "number", default: 10, description: "Number of results (max 50)" },
+        },
+      },
+    },
+    {
+      name: "get_prompt",
+      description: "Get a specific prompt by ID with full content",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Prompt ID (UUID)" },
+        },
+        required: ["id"],
+      },
+    },
+    {
+      name: "list_categories",
+      description: "List all prompt categories available on PromptForge",
+      inputSchema: {
+        type: "object",
+        properties: {},
+      },
+    },
+    {
+      name: "get_trending",
+      description: "Get currently trending prompts",
+      inputSchema: {
+        type: "object",
+        properties: {
+          limit: { type: "number", default: 10, description: "Number of results (max 50)" },
+        },
+      },
+    },
+  ],
+}));
+
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    switch (name) {
+      case "search_prompts": {
+        const params = new URLSearchParams();
+        if (args?.q) params.set("q", args.q);
+        if (args?.model) params.set("model", args.model);
+        if (args?.category) params.set("category", args.category);
+        if (args?.sort) params.set("sort", args.sort);
+        if (args?.limit) params.set("limit", Math.min(args.limit, 50).toString());
+        const data = await fetchApi(`/api/v1/prompts?${params}`);
+        const prompts = (data.data || []).map(formatPrompt);
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ count: prompts.length, prompts, total: data.pagination?.total || 0 }, null, 2),
+          }],
+        };
+      }
+
+      case "get_prompt": {
+        if (!args?.id) throw new Error("Missing required parameter: id");
+        const data = await fetchApi(`/api/v1/prompts/${args.id}`);
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify(formatPrompt(data), null, 2),
+          }],
+        };
+      }
+
+      case "list_categories": {
+        const data = await fetchApi("/api/categories");
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify(data, null, 2),
+          }],
+        };
+      }
+
+      case "get_trending": {
+        const limit = args?.limit ? Math.min(args.limit, 50) : 10;
+        const data = await fetchApi(`/api/v1/prompts?sort=trending&limit=${limit}`);
+        const prompts = (data.data || []).map(formatPrompt);
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({ count: prompts.length, prompts }, null, 2),
+          }],
+        };
+      }
+
+      default:
+        throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true,
+    };
+  }
+});
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("PromptForge MCP server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@promptforge/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for PromptForge — search and retrieve AI prompts from any MCP-compatible client (Claude, Cursor, VS Code, ChatGPT)",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "promptforge-mcp": "index.js"
+  },
+  "files": [
+    "index.js"
+  ],
+  "keywords": [
+    "mcp",
+    "promptforge",
+    "ai",
+    "prompts",
+    "modelcontextprotocol"
+  ],
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jordan-thirkle/promptforge.git",
+    "directory": "mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}