salesforce-metadata-mcp 2.0.0

package/dist/services/mcpgen.js

@@ -0,0 +1,229 @@
+import { promises as fs } from "fs";
+import path from "path";
+// ─── MCP Server Generation ────────────────────────────────────────────────────
+export async function createMcpServer(params) {
+    try {
+        const dir = params.outputDirectory;
+        await fs.mkdir(dir, { recursive: true });
+        await fs.mkdir(path.join(dir, "src"), { recursive: true });
+        const packageJson = {
+            name: params.serverName,
+            version: "1.0.0",
+            description: params.description ?? `MCP server for ${params.serverName}`,
+            type: "module",
+            main: "dist/index.js",
+            scripts: {
+                build: "tsc",
+                start: "node dist/index.js",
+                dev: "tsc --watch"
+            },
+            dependencies: {
+                "@modelcontextprotocol/sdk": "^1.10.2",
+                "axios": "^1.7.9",
+                "zod": "^3.23.8"
+            },
+            devDependencies: {
+                "@types/node": "^22.10.0",
+                "typescript": "^5.7.2"
+            }
+        };
+        const tsconfig = {
+            compilerOptions: {
+                target: "ES2022",
+                module: "Node16",
+                moduleResolution: "Node16",
+                outDir: "./dist",
+                rootDir: "./src",
+                strict: true,
+                esModuleInterop: true,
+                skipLibCheck: true,
+                forceConsistentCasingInFileNames: true,
+                declaration: true,
+                sourceMap: true
+            },
+            include: ["src/**/*"],
+            exclude: ["node_modules", "dist"]
+        };
+        const indexTs = `import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const server = new McpServer({
+  name: "${params.serverName}",
+  version: "1.0.0",
+});
+
+// ─── Tools ────────────────────────────────────────────────────────────────────
+
+server.registerTool(
+  "hello_world",
+  {
+    title: "Hello World",
+    description: "A sample tool that returns a greeting",
+    inputSchema: z.object({
+      name: z.string().optional().describe("Name to greet"),
+    }),
+  },
+  async (params) => {
+    const greeting = \`Hello, \${params.name ?? "World"}!\`;
+    return { content: [{ type: "text", text: greeting }] };
+  }
+);
+
+// ─── Start server ─────────────────────────────────────────────────────────────
+
+async function main(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("${params.serverName} MCP server running on stdio");
+}
+
+main().catch((err: unknown) => {
+  console.error("Server error:", err);
+  process.exit(1);
+});
+`;
+        const envExample = `# Salesforce credentials
+SF_INSTANCE_URL=${params.salesforceInstanceUrl ?? "https://your-org.salesforce.com"}
+SF_ACCESS_TOKEN=your_access_token
+# Or use OAuth refresh:
+# SF_CLIENT_ID=your_client_id
+# SF_CLIENT_SECRET=your_client_secret
+# SF_REFRESH_TOKEN=your_refresh_token
+`;
+        const readme = `# ${params.serverName}
+
+${params.description ?? "A Salesforce MCP Server"}
+
+## Setup
+
+\`\`\`bash
+npm install
+npm run build
+\`\`\`
+
+## Configuration
+
+Copy \`.env.example\` to \`.env\` and fill in your credentials.
+
+## Running
+
+\`\`\`bash
+npm start
+\`\`\`
+
+## Adding to Claude
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${params.serverName}": {
+      "command": "node",
+      "args": ["${path.join(dir, "dist/index.js").replace(/\\/g, "/")}"],
+      "env": {
+        "SF_INSTANCE_URL": "https://your-org.salesforce.com",
+        "SF_ACCESS_TOKEN": "your_token"
+      }
+    }
+  }
+}
+\`\`\`
+`;
+        await fs.writeFile(path.join(dir, "package.json"), JSON.stringify(packageJson, null, 2));
+        await fs.writeFile(path.join(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+        await fs.writeFile(path.join(dir, "src/index.ts"), indexTs);
+        await fs.writeFile(path.join(dir, ".env.example"), envExample);
+        await fs.writeFile(path.join(dir, "README.md"), readme);
+        return {
+            success: true,
+            fullName: params.serverName,
+            created: true,
+            message: `MCP server project created at: ${dir}\n\nFiles created:\n- package.json\n- tsconfig.json\n- src/index.ts\n- .env.example\n- README.md\n\nNext steps:\n1. cd "${dir}"\n2. npm install\n3. npm run build\n4. Add to Claude config`
+        };
+    }
+    catch (err) {
+        return { success: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function createMcpTool(params) {
+    try {
+        const indexPath = path.join(params.projectDirectory, "src/index.ts");
+        let content;
+        try {
+            content = await fs.readFile(indexPath, "utf-8");
+        }
+        catch {
+            return { success: false, message: `Could not read ${indexPath}. Make sure the project directory is correct.` };
+        }
+        const schemaFields = Object.entries(params.inputSchema)
+            .map(([k, v]) => {
+            const field = v;
+            const type = field.type ?? "string";
+            const desc = field.description ?? "";
+            const zodType = type === "number" ? "z.number()" : type === "boolean" ? "z.boolean()" : "z.string()";
+            return `      ${k}: ${zodType}${desc ? `.describe(${JSON.stringify(desc)})` : ""},`;
+        })
+            .join("\n");
+        const toolCode = `
+server.registerTool(
+  "${params.toolName}",
+  {
+    title: "${params.toolName.replace(/_/g, " ").replace(/\b\w/g, l => l.toUpperCase())}",
+    description: ${JSON.stringify(params.toolDescription)},
+    inputSchema: z.object({
+${schemaFields}
+    }),
+  },
+  async (params) => {
+    ${params.handlerCode}
+  }
+);
+`;
+        // Insert before the "Start server" comment or at end of file
+        let newContent;
+        const insertMarker = "// ─── Start server";
+        if (content.includes(insertMarker)) {
+            newContent = content.replace(insertMarker, `${toolCode}\n${insertMarker}`);
+        }
+        else {
+            newContent = content + "\n" + toolCode;
+        }
+        await fs.writeFile(indexPath, newContent, "utf-8");
+        return {
+            success: true,
+            fullName: params.toolName,
+            created: true,
+            message: `Tool '${params.toolName}' added to ${indexPath}. Run 'npm run build' to compile.`
+        };
+    }
+    catch (err) {
+        return { success: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function listMcpTools(projectDirectory) {
+    try {
+        const indexPath = path.join(projectDirectory, "src/index.ts");
+        let content;
+        try {
+            content = await fs.readFile(indexPath, "utf-8");
+        }
+        catch {
+            return { success: false, message: `Could not read ${indexPath}.` };
+        }
+        const toolMatches = [...content.matchAll(/server\.registerTool\(\s*["']([^"']+)["']/g)];
+        const tools = toolMatches.map(m => m[1]);
+        if (!tools.length) {
+            return { success: true, fullName: projectDirectory, created: false, message: "No tools registered in this MCP server project." };
+        }
+        return {
+            success: true,
+            fullName: projectDirectory,
+            created: false,
+            message: `Found ${tools.length} tool(s) in ${indexPath}:\n${tools.map((t, i) => `${i + 1}. ${t}`).join("\n")}`
+        };
+    }
+    catch (err) {
+        return { success: false, message: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=mcpgen.js.map

package/dist/services/mcpgen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpgen.js","sourceRoot":"","sources":["../../src/services/mcpgen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAKrC;IACC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;QACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3D,MAAM,WAAW,GAAG;YAClB,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,kBAAkB,MAAM,CAAC,UAAU,EAAE;YACxE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE;gBACP,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,oBAAoB;gBAC3B,GAAG,EAAE,aAAa;aACnB;YACD,YAAY,EAAE;gBACZ,2BAA2B,EAAE,SAAS;gBACtC,OAAO,EAAE,QAAQ;gBACjB,KAAK,EAAE,SAAS;aACjB;YACD,eAAe,EAAE;gBACf,aAAa,EAAE,UAAU;gBACzB,YAAY,EAAE,QAAQ;aACvB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG;YACf,eAAe,EAAE;gBACf,MAAM,EAAE,QAAQ;gBAChB,MAAM,EAAE,QAAQ;gBAChB,gBAAgB,EAAE,QAAQ;gBAC1B,MAAM,EAAE,QAAQ;gBAChB,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,IAAI;gBACZ,eAAe,EAAE,IAAI;gBACrB,YAAY,EAAE,IAAI;gBAClB,gCAAgC,EAAE,IAAI;gBACtC,WAAW,EAAE,IAAI;gBACjB,SAAS,EAAE,IAAI;aAChB;YACD,OAAO,EAAE,CAAC,UAAU,CAAC;YACrB,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,CAAC;SAClC,CAAC;QAEF,MAAM,OAAO,GAAG;;;;;WAKT,MAAM,CAAC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;mBA0BT,MAAM,CAAC,UAAU;;;;;;;CAOnC,CAAC;QAEE,MAAM,UAAU,GAAG;kBACL,MAAM,CAAC,qBAAqB,IAAI,iCAAiC;;;;;;CAMlF,CAAC;QAEE,MAAM,MAAM,GAAG,KAAK,MAAM,CAAC,UAAU;;EAEvC,MAAM,CAAC,WAAW,IAAI,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;OAwB1C,MAAM,CAAC,UAAU;;kBAEN,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;;;;;;;;;CASpE,CAAC;QAEE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QAExD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,MAAM,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,kCAAkC,GAAG,2HAA2H,GAAG,8DAA8D;SAC3O,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAMnC;IACC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QACrE,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,SAAS,+CAA+C,EAAE,CAAC;QACjH,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,MAAM,KAAK,GAAG,CAA4B,CAAC;YAC3C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,IAAI,QAAQ,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,WAAqB,IAAI,EAAE,CAAC;YAC/C,MAAM,OAAO,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;YACrG,OAAO,SAAS,CAAC,KAAK,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QACtF,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,QAAQ,GAAG;;KAEhB,MAAM,CAAC,QAAQ;;cAEN,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;mBACpE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC;;EAEvD,YAAY;;;;MAIR,MAAM,CAAC,WAAW;;;CAGvB,CAAC;QAEE,6DAA6D;QAC7D,IAAI,UAAkB,CAAC;QACvB,MAAM,YAAY,GAAG,qBAAqB,CAAC;QAC3C,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,QAAQ,KAAK,YAAY,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;QACzC,CAAC;QAED,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAEnD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,SAAS,MAAM,CAAC,QAAQ,cAAc,SAAS,mCAAmC;SAC5F,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,gBAAwB;IACzD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAC9D,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,SAAS,GAAG,EAAE,CAAC;QACrE,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACxF,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;QACnI,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,gBAAgB;YAC1B,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,SAAS,KAAK,CAAC,MAAM,eAAe,SAAS,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC/G,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACvF,CAAC;AACH,CAAC"}