@snokam/mcp-server 0.2.0 → 0.3.0

package/dist/index.js

@@ -8,7 +8,7 @@
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { fetchSpecs } from "./openapi-loader.js";
 import { getAccessToken } from "./auth.js";
 // ---------------------------------------------------------------------------
@@ -120,7 +120,102 @@ async function main() {
     for (const ep of endpoints) {
         endpointsByTool.set(ep.toolName, ep);
     }
-    const server = new Server({ name: "snokam", version: "0.1.0" }, { capabilities: { tools: {} } });
+    const server = new Server({
+        name: "snokam",
+        version: "0.2.0",
+    }, {
+        capabilities: {
+            tools: {},
+            resources: {},
+        },
+    });
+    // List resources
+    server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+        resources: [
+            {
+                uri: "snokam://about",
+                name: "About Snøkam",
+                description: "Information about Snøkam and available API services",
+                mimeType: "text/markdown",
+            },
+        ],
+    }));
+    // Read resource
+    server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+        const { uri } = request.params;
+        if (uri === "snokam://about") {
+            // Group endpoints by service with their descriptions
+            const serviceMap = new Map();
+            for (const ep of endpoints) {
+                const existing = serviceMap.get(ep.service);
+                if (existing) {
+                    existing.count++;
+                }
+                else {
+                    serviceMap.set(ep.service, {
+                        count: 1,
+                        description: ep.serviceDescription,
+                    });
+                }
+            }
+            const serviceList = Array.from(serviceMap.entries())
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([service, { count, description }]) => {
+                return `- **${service}** (${count} endpoints): ${description}`;
+            })
+                .join("\n");
+            const about = `# Snøkam MCP Server
+
+**Snøkam** is a Norwegian software consulting company. This MCP server provides programmatic access to Snøkam's internal backend APIs.
+
+## Environment
+
+Currently connected to: **${ENVIRONMENT}**
+
+## Available Services
+
+${serviceList}
+
+## Authentication
+
+- **Public endpoints**: No authentication required (e.g., \`employees__GetEmployeesPublic\`)
+- **Protected endpoints**: Require Azure AD authentication (e.g., \`employees__GetEmployeesProtected\`)
+
+## Common Use Cases
+
+**Find out who works at Snøkam:**
+\`\`\`
+Use: employees__GetEmployeesPublic
+Returns: List of all employees with names, roles, and technologies
+\`\`\`
+
+**Get upcoming events:**
+\`\`\`
+Use: events__GetPublicEvents (if available)
+Returns: Company events and gatherings
+\`\`\`
+
+**Check office status or control music:**
+\`\`\`
+Use: office__* tools
+Controls: Sonos speakers, lights, YouTube queue
+\`\`\`
+`;
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: "text/markdown",
+                        text: about,
+                    },
+                ],
+            };
+        }
+        return {
+            contents: [],
+            isError: true,
+        };
+    });
     // List tools
     server.setRequestHandler(ListToolsRequestSchema, async () => ({
         tools: endpoints.map((ep) => ({

package/dist/openapi-loader.d.ts

@@ -8,6 +8,7 @@
  */
 export interface ApiEndpoint {
     service: string;
+    serviceDescription: string;
     toolName: string;
     operationId: string;
     method: string;

package/dist/openapi-loader.js

@@ -70,6 +70,7 @@ function parseSpec(spec, service, baseUrl) {
     const paths = spec.paths;
     if (!paths || Object.keys(paths).length === 0)
         return endpoints;
+    const serviceDescription = spec.info.description || spec.info.title || "";
     for (const [path, pathItem] of Object.entries(paths)) {
         for (const method of ["get", "post", "put", "patch", "delete"]) {
             const operation = pathItem[method];
@@ -81,6 +82,7 @@ function parseSpec(spec, service, baseUrl) {
             const scope = extractScope(operation);
             endpoints.push({
                 service,
+                serviceDescription,
                 toolName: makeToolName(service, operationId),
                 operationId,
                 method: method.toUpperCase(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snokam/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server exposing Snokam backend APIs as tools",
   "type": "module",
   "bin": {

package/specs/test/broker.json

@@ -0,0 +1,109 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "Broker Function",
+    "description": "Message broker for Sanity events (Webhook) to Azure Service Bus / PubSub",
+    "version": "v1.0.0"
+  },
+  "servers": [
+    {
+      "url": "https://broker.api.test.snokam.no"
+    }
+  ],
+  "paths": {
+    "/v1.0/sanity-webhook-to-azure": {
+      "post": {
+        "tags": [
+          "Sanity"
+        ],
+        "summary": "Handles Sanity webhook events",
+        "description": "This function processes events from Sanity webhooks and forwards them to Azure Web PubSub and Service Bus.",
+        "operationId": "SanityWebhookToAzure",
+        "requestBody": {
+          "description": "The Sanity webhook payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/sanityDocument"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Event processed successfully",
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    },
+    "/v1.0/pubsub/tv/uri": {
+      "get": {
+        "tags": [
+          "WebPubSub"
+        ],
+        "summary": "Gets a Web PubSub token",
+        "description": "Generates a Web PubSub token for joining and leaving the 'tv' group.",
+        "operationId": "GetPubsubToken",
+        "responses": {
+          "200": {
+            "description": "Web PubSub token generated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/pubSubToken"
+                }
+              }
+            },
+            "x-ms-summary": "Success"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "pubSubToken": {
+        "type": "object",
+        "properties": {
+          "uri": {
+            "type": "string",
+            "nullable": true
+          }
+        }
+      },
+      "sanityDocument": {
+        "type": "object",
+        "properties": {
+          "_id": {
+            "type": "string",
+            "nullable": true
+          },
+          "_type": {
+            "type": "string",
+            "nullable": true
+          },
+          "_rev": {
+            "type": "string",
+            "nullable": true
+          },
+          "_key": {
+            "type": "string",
+            "nullable": true
+          },
+          "_createdAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          },
+          "_updatedAt": {
+            "type": "string",
+            "format": "date-time",
+            "nullable": true
+          }
+        }
+      }
+    }
+  }
+}