rhombus-node-mcp 0.1.0 → 0.1.2

package/README.md

@@ -4,40 +4,28 @@ An MCP server implementation that integrates the Rhombus API to provide Chatbot
 
 ## Configuration
 
-### Step 1:
-
-Clone this repository:
-
-```bash
-git clone git@github.com:RhombusSystems/rhombus-node-mcp.git
-```
-
-Navigate to the `rhombus-node-mcp` directory and install the necessary dependencies:
-
-```bash
-cd rhombus-node-mcp && npm install
-```
-
-### Step 2: Get a Rhombus API Key
+### Step 1: Get a Rhombus API Key
 
 1. Sign up for a [Rhombus Account](https://console.rhombus.com).
-2. Follow the account setup instructions and generate your API key from the developer dashboard.
+2. Create an API Key at [API Key Settings](https://console.rhombus.com/settings/api-management)
 3. Set the API key in your environment as `RHOMBUS_API_KEY`.
 
-### Step 3: Configure Claude Desktop
+### Step 2: Configure Claude Desktop
 
 1. Download Claude desktop [here](https://claude.ai/download).
 
 2. Add this to your `claude_desktop_config.json`:
 
+### DOCKER
+
 ```json
 {
   "mcpServers": {
     "rhombus": {
       "command": "docker",
-      "args": ["run", "-i", "--rm", "-e", "RHOMBUS-API-KEY", "mcp/rhombus"],
+      "args": ["run", "-i", "--rm", "-e", "RHOMBUS_API_KEY", "mcp-server-rhombus"],
       "env": {
-        "RHOMBUS_API_KEY": "YOUR_API_KEY_HERE"
+        "RHOMBUS_API_KEY": "YOUR_API_KEY"
       }
     }
   }
@@ -66,17 +54,9 @@ You can access the file using:
 vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
 ```
 
-### Step 4: Build the Docker Image
-
-Docker build:
-
-```bash
-docker build -t mcp/rhombus:latest -f Dockerfile .
-```
-
-### Step 5: Testing
+### Step 3: Testing
 
-Let's make sure Claude for Desktop is picking up the tools we've exposed in our `rhombus` server. You can do this by looking for the hammer icon:
+Let's make sure Claude for Desktop is picking up the tools we've exposed in our `rhombus` server. You can do this by looking for the hammer icon.
 
 After clicking on the hammer icon, you should see the tools that come with the Filesystem MCP Server:
 

package/dist/index.js

@@ -28,6 +28,12 @@ async function postApi(url, body) {
     try {
         const response = await fetch(url, { method: "POST", headers, body });
         if (!response.ok) {
+            if (response.status === 401 || response.status === 403) {
+                return {
+                    error: true,
+                    status: "Sorry, I don't have permission to help with this request.  Consider upgrading my permissions by changing the role of the API Key I am using.",
+                };
+            }
             throw new Error(`HTTP error! status: ${response.status}`);
         }
         return await response.json();
@@ -133,6 +139,41 @@ async function rebootCameras(cameraUuids) {
         return { status, successCount, errorCount };
     }
 }
+async function getImageForCameraAtTime(cameraUuid, timestampMs) {
+    const url = BASE_URL + "/video/getExactFrameUri";
+    const body = JSON.stringify({
+        cameraUuid: cameraUuid,
+        downscaleFactor: 10,
+        jpgQuality: 70,
+        permyriadCropHeight: 10000,
+        permyriadCropWidth: 5625,
+        permyriadCropX: 2188,
+        permyriadCropY: 0,
+        timestampMs: timestampMs,
+    });
+    const base64Image = await postApi(url, body).then(async (res) => {
+        return await fetch(res.frameUri, { method: "GET", headers: headers }).then(async (res) => {
+            if (!res.ok)
+                return null;
+            const arrayBuffer = await res.arrayBuffer();
+            const buffer = Buffer.from(arrayBuffer);
+            const base64 = buffer.toString("base64");
+            return base64;
+        });
+    });
+    if (!base64Image) {
+        return {
+            success: false,
+            status: "failed to fetch image",
+        };
+    }
+    return {
+        success: true,
+        status: "successfully fetched image",
+        imageType: "base64",
+        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();
     return {
@@ -144,9 +185,9 @@ server.tool("get-org-information", "Get general information about the organizati
         ],
     };
 });
-server.tool("get-entity-tool", "get a list of entities like cameras, access controlled doors, sensors, etc.", {
+server.tool("get-entity-tool", "get a list of entities like cameras, access controlled doors, sensors, images from cameras, etc.", {
     entityType: z
-        .enum(["camera", "access-controlled-doors"])
+        .enum(["camera", "access-controlled-doors", "image-frame"])
         .describe("The entity type to retreive.  Example: cameras."),
 }, async ({ entityType }) => {
     let ret;
@@ -170,6 +211,72 @@ 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", {
+    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 }) => {
+    if (!cameraUuid) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        needUserInput: true,
+                        commandForUser: "Which camera are you talking about?",
+                    }),
+                },
+            ],
+        };
+    }
+    if (!timestampMs) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        needUserInput: true,
+                        commandForUser: "At what time?",
+                    }),
+                },
+            ],
+        };
+    }
+    let response;
+    switch (requestType) {
+        case "image":
+            response = await getImageForCameraAtTime(cameraUuid, timestampMs);
+            if (!response.success || !response.imageData) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response) }],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "image",
+                        data: response.imageData,
+                        mimeType: "image/jpeg",
+                    },
+                ],
+            };
+            break;
+        default:
+            response = {
+                error: true,
+                status: "mising unknown type from tool call",
+            };
+            break;
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ response }),
+            },
+        ],
+    };
+});
 server.tool("events-tool", "event data for certain types of information like faces and license plates", {
     eventType: z.enum(["faces", "people", "access-control"]),
     locationUuid: z.optional(z.string()),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhombus-node-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server for Rhombus API",
   "keywords": [
     "ai",
@@ -37,8 +37,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.14.0",
-    "typescript": "^5.8.3",
-    "prettier": "3.5.3"
+    "prettier": "3.5.3",
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=18"