bi-superpowers 1.0.0

package/desktop-extension/server.js

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+
+/**
+ * BI Agent Superpowers — MCP Server for Claude Desktop
+ *
+ * Lightweight MCP server that exposes each bi-superpowers skill as a
+ * Claude Desktop prompt. Bundled into a .mcpb extension via
+ * `super build-desktop`.
+ *
+ * Skills are loaded from the ./skills/ directory (copied in at build time).
+ */
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const skillsDir = path.join(__dirname, 'skills');
+
+// Create the MCP server instance.
+const server = new McpServer({
+  name: 'bi-superpowers',
+  version: '0.0.0-template',
+});
+
+function loadBundledSkills(directory) {
+  if (!fs.existsSync(directory)) {
+    return [];
+  }
+
+  const skills = [];
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const entryPath = path.join(directory, entry.name);
+
+    if (entry.isFile() && entry.name.endsWith('.md')) {
+      skills.push({
+        name: path.basename(entry.name, '.md'),
+        bundleDir: directory,
+        content: fs.readFileSync(entryPath, 'utf8'),
+      });
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      const skillPath = path.join(entryPath, 'SKILL.md');
+      if (fs.existsSync(skillPath)) {
+        skills.push({
+          name: entry.name,
+          bundleDir: entryPath,
+          content: fs.readFileSync(skillPath, 'utf8'),
+        });
+      }
+    }
+  }
+
+  return skills.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// Register each skill as an MCP prompt that Claude Desktop can invoke.
+for (const skill of loadBundledSkills(skillsDir)) {
+  const { name, bundleDir, content } = skill;
+
+  // Use the first non-header line as a short description for the prompt.
+  const firstLine = content.split('\n').find((l) => l.trim() && !l.startsWith('#'));
+  const description = firstLine ? firstLine.slice(0, 120).trim() : `BI Superpowers: ${name}`;
+  const promptText = [
+    `Bundled skill directory: ${bundleDir}`,
+    'Resolve this skill\'s references/ and scripts/ paths relative to that directory.',
+    '',
+    content,
+  ].join('\n');
+
+  server.prompt(name, { description }, () => ({
+    messages: [
+      {
+        role: 'user',
+        content: { type: 'text', text: promptText },
+      },
+    ],
+  }));
+}
+
+// Register a setup-mcp helper prompt that explains how to wire the
+// official Microsoft MCP servers (Power BI Modeling + Microsoft Learn)
+// into Claude Desktop.
+server.prompt(
+  'setup-mcp',
+  {
+    description:
+      'Instructions to configure the Power BI Modeling and Microsoft Learn MCP servers in Claude Desktop',
+  },
+  () => ({
+    messages: [
+      {
+        role: 'user',
+        content: {
+          type: 'text',
+          text: `# Configure MCP Servers for Claude Desktop
+
+bi-superpowers ships two official Microsoft MCP servers. To wire them
+into Claude Desktop, add the following to your \`claude_desktop_config.json\`
+(Settings → Developer → Edit Config):
+
+\`\`\`json
+{
+  "mcpServers": {
+    "powerbi-modeling-mcp": {
+      "command": "node",
+      "args": ["<absolute path to powerbi-modeling-launcher.js>"]
+    },
+    "microsoft-learn": {
+      "type": "http",
+      "url": "https://learn.microsoft.com/api/mcp"
+    }
+  }
+}
+\`\`\`
+
+The \`powerbi-modeling-mcp\` server requires Power BI Desktop on Windows
+with a model open. If you prefer automated setup, run
+\`super install\` from the bi-superpowers CLI — it configures both
+servers across all 5 supported AI agents.
+
+After saving, restart Claude Desktop. The MCP servers will appear in
+your tools.
+`,
+        },
+      },
+    ],
+  })
+);
+
+// Start the server with stdio transport.
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "bi-superpowers",
+  "version": "1.0.0",
+  "description": "Open-source Power BI Desktop toolkit for Claude Code, GitHub Copilot, Codex, Gemini CLI, and Kilo Code. Ships 9 BI skills and 2 official Microsoft MCP servers.",
+  "main": "bin/cli.js",
+  "bin": {
+    "bi-superpowers": "bin/cli.js",
+    "super": "bin/cli.js"
+  },
+  "scripts": {
+    "build:plugin": "node bin/build-plugin.js",
+    "postinstall": "node bin/postinstall.js",
+    "lint": "eslint bin/ --max-warnings=0",
+    "lint:fix": "eslint bin/ --fix --max-warnings=0",
+    "lint:skills": "node bin/cli.js checkup",
+    "format": "prettier --write bin/",
+    "format:check": "prettier --check bin/",
+    "test": "node --test \"bin/**/*.test.js\" \"src/content/**/*.test.js\"",
+    "audit": "npm audit --audit-level=moderate",
+    "check": "npm run lint && npm run format:check",
+    "prepack": "npm run build:plugin && npm run check"
+  },
+  "dependencies": {
+    "adm-zip": "^0.5.17",
+    "boxen": "^5.1.2",
+    "chalk": "^4.1.2",
+    "chokidar": "^4.0.3",
+    "cli-table3": "^0.6.5",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^10.3.0",
+    "globals": "^17.2.0",
+    "prettier": "^3.2.5"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/luquimbo/bi-superpowers.git"
+  },
+  "bugs": {
+    "url": "https://github.com/luquimbo/bi-superpowers/issues"
+  },
+  "homepage": "https://bi-superpowers.dev",
+  "keywords": [
+    "power-bi",
+    "excel",
+    "dax",
+    "power-query",
+    "mcp",
+    "ai-agent",
+    "business-intelligence",
+    "data-modeling",
+    "semantic-model",
+    "ibcs",
+    "data-visualization",
+    "fabric",
+    "tmdl",
+    "claude-plugin",
+    "claude-code",
+    "claude-desktop",
+    "mcpb",
+    "ai-superpowers"
+  ],
+  "author": "Lucas Sanchez (luquimbo)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "bin/",
+    ".claude-plugin/",
+    ".plugin/",
+    ".mcp.json",
+    "commands/",
+    "skills/",
+    "src/content/",
+    "templates/",
+    "theme/",
+    "desktop-extension/",
+    "config.json",
+    "config.example.json",
+    "README.md",
+    "LICENSE",
+    "!**/*.test.js",
+    "!**/.pbi/**",
+    "!**/DAXQueries/**",
+    "!**/*.pbix",
+    "!**/*.pbit"
+  ]
+}