rhombus-node-mcp 0.1.3 → 0.1.5

package/README.md

@@ -23,9 +23,16 @@ An MCP server implementation that integrates the Rhombus API to provide Chatbot
   "mcpServers": {
     "rhombus": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "-e", "RHOMBUS_API_KEY", "mcp-server-rhombus"],
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "RHOMBUS_API_KEY=YOUR_API_KEY_HERE",
+        "mcp-server-rhombus"
+      ],
       "env": {
-        "RHOMBUS_API_KEY": "YOUR_API_KEY"
+        "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
       }
     }
   }
@@ -39,7 +46,7 @@ An MCP server implementation that integrates the Rhombus API to provide Chatbot
   "mcpServers": {
     "rhombus": {
       "command": "npx",
-      "args": ["-y", "server-rhombus"],
+      "args": ["--yes", "--package", "rhombus-node-mcp", "mcp-server-rhombus"],
       "env": {
         "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
       }

package/dist/index.js

@@ -7,14 +7,16 @@ const FIVE_SECONDS_MS = 5 * 1000;
 const RHOMBUS_API_KEY = process.env.RHOMBUS_API_KEY;
 if (!RHOMBUS_API_KEY) {
     console.error("Missing RHOMBUS_API_KEY");
-    process.exit(1);
 }
 const BASE_URL = "https://api2.rhombussystems.com/api";
-const headers = {
+const STATIC_HEADERS = {
     "Content-Type": "application/json",
+    accept: "application/json",
+};
+const AUTH_HEADERS = {
     "x-auth-apikey": RHOMBUS_API_KEY,
     "x-auth-scheme": "api-token",
-    accept: "application/json",
+    "x-rhombus-agent": "chatbot",
 };
 const server = new McpServer({
     name: "rhombus",
@@ -24,7 +26,26 @@ const server = new McpServer({
         tools: {},
     },
 });
-async function postApi(url, body) {
+const STATIC_ARGS = {
+    headers: z
+        .optional(z.any())
+        .describe("Optional headers accepted by tools.  LLM should never ever use this. 😅"),
+};
+const shouldUseCustomHeaders = (headers) => {
+    let valid = true;
+    if (!headers)
+        return false;
+    Object.keys(headers).forEach(key => {
+        if (headers[key].length === 0)
+            valid = false;
+    });
+    return valid;
+};
+async function postApi(url, body, customHeaders) {
+    let headers = {
+        ...(shouldUseCustomHeaders(customHeaders) ? customHeaders : AUTH_HEADERS),
+        ...STATIC_HEADERS,
+    };
     try {
         const response = await fetch(url, { method: "POST", headers, body });
         if (!response.ok) {
@@ -45,27 +66,28 @@ async function postApi(url, body) {
         };
     }
 }
-async function getOrg() {
+async function getOrg(headers) {
     const url = BASE_URL + "/org/getOrgV2";
-    return await postApi(url, "{}");
+    return await postApi(url, "{}", headers);
 }
-async function getLocations() {
+async function getLocations(headers) {
     const url = BASE_URL + "/location/getLocationsV2";
-    return await postApi(url, "{}");
+    console.error("headers:", JSON.stringify(headers));
+    return await postApi(url, "{}", headers);
 }
-async function getCameraList() {
+async function getCameraList(headers) {
     const url = BASE_URL + "/camera/getMinimalCameraStateList";
-    return await postApi(url, "{}").then(response => {
+    return await postApi(url, "{}", headers).then(response => {
         return {
             cameraStates: response.cameraStates.filter((camera) => !!camera.locationUuid),
         };
     });
 }
-async function getAccessControlledDoors() {
+async function getAccessControlledDoors(headers) {
     const url = BASE_URL + "/component/findAccessControlledDoors";
-    return await postApi(url, "{}");
+    return await postApi(url, "{}", headers);
 }
-async function getFaceEvents(_locationUuid) {
+async function getFaceEvents(_locationUuid, headers) {
     const nowMs = Date.now();
     const rangeStartMs = nowMs - THREE_HOURS_MS;
     const rangeEndMs = nowMs - FIVE_SECONDS_MS;
@@ -86,7 +108,7 @@ async function getFaceEvents(_locationUuid) {
             },
         },
     });
-    const response = await postApi(BASE_URL + "/faceRecognition/faceEvent/findFaceEventsByOrg", body).then(response => {
+    const response = await postApi(BASE_URL + "/faceRecognition/faceEvent/findFaceEventsByOrg", body, headers).then(response => {
         return {
             faceEvents: (response.faceEvents || []).map((event) => ({
                 ...event,
@@ -96,13 +118,13 @@ async function getFaceEvents(_locationUuid) {
     });
     return response;
 }
-async function getAccessControlEvents(doorUuid) {
+async function getAccessControlEvents(doorUuid, headers) {
     const url = BASE_URL + "/component/findComponentEventsByAccessControlledDoor";
     const body = JSON.stringify({
         limit: 50,
         accessControlledDoorUuid: doorUuid,
     });
-    const response = await postApi(url, body).then(response => ({
+    const response = await postApi(url, body, headers).then(response => ({
         componentEvents: (response.componentEvents || []).map((event) => ({
             ...event,
             timestamp: new Date(event.timestampMs).toString(),
@@ -110,14 +132,14 @@ async function getAccessControlEvents(doorUuid) {
     }));
     return response;
 }
-async function rebootCameras(cameraUuids) {
+async function rebootCameras(cameraUuids, headers) {
     const url = BASE_URL + "/camera/reboot";
     let successCount = 0;
     let errorCount = 0;
     for (const cameraUuid in cameraUuids) {
         try {
             const body = JSON.stringify({ cameraUuid: cameraUuid });
-            const response = await postApi(url, body);
+            const response = await postApi(url, body, headers);
             if (response.error) {
                 errorCount++;
             }
@@ -139,7 +161,7 @@ async function rebootCameras(cameraUuids) {
         return { status, successCount, errorCount };
     }
 }
-async function getImageForCameraAtTime(cameraUuid, timestampMs) {
+async function getImageForCameraAtTime(cameraUuid, timestampMs, headers) {
     const url = BASE_URL + "/video/getExactFrameUri";
     const body = JSON.stringify({
         cameraUuid: cameraUuid,
@@ -151,7 +173,7 @@ async function getImageForCameraAtTime(cameraUuid, timestampMs) {
         permyriadCropY: 0,
         timestampMs: timestampMs,
     });
-    const base64Image = await postApi(url, body).then(async (res) => {
+    const base64Image = await postApi(url, body, headers).then(async (res) => {
         return await fetch(res.frameUri, { method: "GET", headers: headers }).then(async (res) => {
             if (!res.ok)
                 return null;
@@ -174,8 +196,8 @@ async function getImageForCameraAtTime(cameraUuid, timestampMs) {
         imageData: base64Image,
     };
 }
-server.tool("get-org-information", "Get general information about the organization including org name, camera configuration defaults, contact information, and org settings.", {}, async ({}) => {
-    const org = await getOrg();
+server.tool("get-org-information", "Get general information about the organization including org name, camera configuration defaults, contact information, and org settings.", { ...STATIC_ARGS }, async ({ headers }) => {
+    const org = await getOrg(headers);
     return {
         content: [
             {
@@ -189,14 +211,15 @@ server.tool("get-entity-tool", "get a list of entities like cameras, access cont
     entityType: z
         .enum(["camera", "access-controlled-doors"])
         .describe("The entity type to retreive.  Example: cameras."),
-}, async ({ entityType }) => {
+    ...STATIC_ARGS,
+}, async ({ entityType, headers }) => {
     let ret;
     switch (entityType) {
         case "camera":
-            ret = await getCameraList();
+            ret = await getCameraList(headers);
             break;
         case "access-controlled-doors":
-            ret = await getAccessControlledDoors();
+            ret = await getAccessControlledDoors(headers);
             break;
         default:
             ret = {};
@@ -211,11 +234,12 @@ server.tool("get-entity-tool", "get a list of entities like cameras, access cont
         ],
     };
 });
-server.tool("camera-tool", "get specific requested information about a camera such as an image snapshot, or detailed analytics info", {
+server.tool("camera-tool", "get specific requested information about a camera such as an image snapshot, or detailed analytics info.  this can be used to answer questions about tracking people across cameras", {
     requestType: z.enum(["image"]),
     timestampMs: z.optional(z.number()).describe("the timestamp in milliseconds"),
     cameraUuid: z.optional(z.string()).describe("the camera uuid requested"),
-}, async ({ cameraUuid, timestampMs, requestType }) => {
+    ...STATIC_ARGS,
+}, async ({ cameraUuid, timestampMs, requestType, headers }) => {
     if (!cameraUuid) {
         return {
             content: [
@@ -245,7 +269,7 @@ server.tool("camera-tool", "get specific requested information about a camera su
     let response;
     switch (requestType) {
         case "image":
-            response = await getImageForCameraAtTime(cameraUuid, timestampMs);
+            response = await getImageForCameraAtTime(cameraUuid, timestampMs, headers);
             if (!response.success || !response.imageData) {
                 return {
                     content: [{ type: "text", text: JSON.stringify(response) }],
@@ -281,9 +305,10 @@ server.tool("events-tool", "event data for certain types of information like fac
     eventType: z.enum(["faces", "people", "access-control"]),
     locationUuid: z.optional(z.string()),
     accessControlledDoorUuid: z.optional(z.string()),
-}, async ({ eventType, locationUuid, accessControlledDoorUuid }) => {
+    ...STATIC_ARGS,
+}, async ({ eventType, locationUuid, accessControlledDoorUuid, headers }) => {
     if (eventType === "faces" || eventType === "people") {
-        const response = await getFaceEvents(locationUuid);
+        const response = await getFaceEvents(locationUuid, headers);
         return {
             content: [
                 {
@@ -308,7 +333,7 @@ server.tool("events-tool", "event data for certain types of information like fac
             };
         }
         else {
-            const events = await getAccessControlEvents(accessControlledDoorUuid);
+            const events = await getAccessControlEvents(accessControlledDoorUuid, headers);
             return {
                 content: [
                     {
@@ -331,11 +356,12 @@ server.tool("events-tool", "event data for certain types of information like fac
 server.tool("location-tool", "contains basic operations for locations and response in JSON format.", {
     action: z.enum(["get"]),
     locationUpdate: z.optional(z.object({ uuid: z.string(), name: z.optional(z.string()) })),
-}, async ({ action, locationUpdate }) => {
+    ...STATIC_ARGS,
+}, async ({ action, locationUpdate, headers }) => {
     let ret;
     switch (action) {
         case "get":
-            ret = await getLocations();
+            ret = await getLocations(headers);
             break;
         default:
             ret = { error: true, status: `unsupported location tool call: ${action}` };
@@ -349,8 +375,9 @@ server.tool("reboot-cameras", "this tool is for rebooting one or more cameras ca
     cameraUuids: z
         .array(z.string())
         .describe("An array of camera UUID strings which are unique identifiers for cameras"),
-}, async ({ cameraUuids }) => {
-    const cameraRebootData = await rebootCameras(cameraUuids);
+    ...STATIC_ARGS,
+}, async ({ cameraUuids, headers }) => {
+    const cameraRebootData = await rebootCameras(cameraUuids, headers);
     if (!cameraRebootData) {
         return {
             content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhombus-node-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "MCP server for Rhombus API",
   "keywords": [
     "ai",