@skillbrickai/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# @skillbrickai/mcp-server
+
+MCP (Model Context Protocol) server for discovering and installing skills from the [SkillBrick AI](https://skillbrickai.com) platform. This lets AI agents like Claude search, browse, and install skills directly.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_skills` | Search and browse skills by query, domain, tag, or sort order. Auto-infers domain and technology from natural language queries. |
+| `get_skill` | Get full skill details including prompt content |
+| `install_skill` | Install a skill (requires auth token) |
+| `upload_skill` | Upload or update a skill (upsert, requires auth token) |
+| `sync_skills` | Bulk-sync multiple skills in one call (requires auth token) |
+| `my_skills` | List all skills owned by the authenticated user |
+| `check_credits` | Check download credit balance |
+| `list_collections` | Browse skill collections |
+| `get_collection` | Get a collection with all its skills |
+| `list_domains` | List available skill domains/categories |
+| `recommend_skills` | Intelligent skill recommendations based on a task description |
+
+## Setup
+
+### Build
+
+```bash
+pnpm install
+pnpm --filter @skillbrickai/mcp-server build
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config file (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "skillbrickai": {
+      "command": "node",
+      "args": ["C:/Users/user/Documents/skillbrickai/packages/mcp-server/dist/index.js"],
+      "env": {
+        "SKILLBRICK_API_URL": "https://skillbrickai.com",
+        "SKILLBRICK_API_TOKEN": "your-api-token-here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add skillbrick -- node C:/Users/user/Documents/skillbrickai/packages/mcp-server/dist/index.js
+```
+
+Or via npx (once published):
+
+```bash
+claude mcp add skillbrick -- npx @skillbrickai/mcp-server
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `SKILLBRICK_API_URL` | Base URL for the SkillBrick API | `https://skillbrickai.com` |
+| `SKILLBRICK_API_TOKEN` | API auth token (required for `install_skill`, `upload_skill`, `sync_skills`, `my_skills`, `check_credits`) | _(none)_ |
+
+## How the search works
+
+1. **Intent parsing** -- extracts domain and technology tags from natural language
+2. **Domain inference** -- maps casual terms ("backend", "k8s") to actual domain values
+3. **Multi-pass search** -- queries by text, inferred domain, and inferred tags in parallel
+4. **Relevance scoring** -- scores results by name/description/tag match + popularity signals
+5. **Fallback broadening** -- if filtered search returns nothing, retries without filters

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * HTTP transport entry point for the SkillBrick AI MCP server.
+ *
+ * Exposes the MCP server over Streamable HTTP so it can be accessed
+ * by remote clients like Smithery, rather than requiring a local stdio process.
+ *
+ * Usage:
+ *   SKILLBRICK_API_URL=https://api.skillbrickai.com node dist/http.js
+ *
+ * The server listens on PORT (default 3001) and serves the MCP protocol at /mcp.
+ */
+export {};

package/dist/http.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+/**
+ * HTTP transport entry point for the SkillBrick AI MCP server.
+ *
+ * Exposes the MCP server over Streamable HTTP so it can be accessed
+ * by remote clients like Smithery, rather than requiring a local stdio process.
+ *
+ * Usage:
+ *   SKILLBRICK_API_URL=https://api.skillbrickai.com node dist/http.js
+ *
+ * The server listens on PORT (default 3001) and serves the MCP protocol at /mcp.
+ */
+import express from "express";
+import { randomUUID } from "crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createSkillBrickServer } from "./server.js";
+const PORT = parseInt(process.env.MCP_PORT || "3001", 10);
+// Map of session ID -> transport (for stateful connections)
+const transports = new Map();
+const app = express();
+app.use(express.json());
+// Health check
+app.get("/health", (_req, res) => {
+    res.json({ status: "ok", service: "skillbrickai-mcp" });
+});
+// Handle MCP Streamable HTTP requests
+app.all("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    if (req.method === "GET") {
+        // SSE stream for server-initiated messages
+        if (!sessionId || !transports.has(sessionId)) {
+            res.status(400).json({ error: "Missing or invalid session ID. Initialize with a POST first." });
+            return;
+        }
+        const transport = transports.get(sessionId);
+        await transport.handleRequest(req, res);
+        return;
+    }
+    if (req.method === "POST") {
+        // Check if this is an initialization request (no session ID)
+        if (!sessionId) {
+            // New session — create transport and server
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            const server = createSkillBrickServer();
+            await server.connect(transport);
+            // Store the transport by session ID after the init response sets it
+            transport.onclose = () => {
+                if (transport.sessionId) {
+                    transports.delete(transport.sessionId);
+                }
+            };
+            await transport.handleRequest(req, res);
+            // After handling, the transport now has a session ID
+            if (transport.sessionId) {
+                transports.set(transport.sessionId, transport);
+            }
+            return;
+        }
+        // Existing session
+        const transport = transports.get(sessionId);
+        if (!transport) {
+            res.status(404).json({ error: "Session not found. It may have expired." });
+            return;
+        }
+        await transport.handleRequest(req, res);
+        return;
+    }
+    if (req.method === "DELETE") {
+        // Session termination
+        if (sessionId && transports.has(sessionId)) {
+            const transport = transports.get(sessionId);
+            await transport.close();
+            transports.delete(sessionId);
+        }
+        res.status(200).json({ message: "Session closed" });
+        return;
+    }
+    res.status(405).json({ error: "Method not allowed" });
+});
+app.listen(PORT, "0.0.0.0", () => {
+    console.log(`SkillBrick AI MCP server (HTTP) running on http://0.0.0.0:${PORT}`);
+    console.log(`MCP endpoint: http://0.0.0.0:${PORT}/mcp`);
+    console.log(`Health check: http://0.0.0.0:${PORT}/health`);
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createSkillBrickServer } from "./server.js";
+async function main() {
+    const server = createSkillBrickServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error starting MCP server:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createSkillBrickServer(): McpServer;