Rhombus MCP Server

import { CallToolResult } from "@modelcontextprotocol/sdk/types.js"; import { z } from "zod"; import fs from "fs"; import path from "path"; import { DateTime } from "luxon"; export function generateRandomString(length: number): string { const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789"; let result = ""; const charactersLength = characters.length; for (let i = 0; i < length; i++) { result += characters.charAt(Math.floor(Math.random() * charactersLength)); } return result; } export const RequestModifiers = z .object({ headers: z.optional(z.record(z.string(), z.string())), query: z.optional(z.record(z.string(), z.string())), }) .optional(); export type RequestModifiers = z.infer<typeof RequestModifiers>; export type ToolExtra = { _meta?: { requestModifiers?: RequestModifiers; }; sessionId?: string; }; export function extractFromToolExtra(_extra: unknown) { const extra = _extra as ToolExtra; return { requestModifiers: extra._meta?.requestModifiers, sessionId: extra.sessionId, }; } /** * Get all file paths in a directory in a directory * * i.e. * foo: * - folder1: * - har * - gar * - bar * - lar * * returns: ["folder1/har", "folder1/gar", "bar", "lar"] */ export function getFilePathsInDirectory(dirPath: string): string[] { const filePaths: string[] = []; const fileNames = fs.readdirSync(dirPath); for (const fileName of fileNames) { const pathToAdd = path.join(dirPath, fileName); const stats = fs.lstatSync(pathToAdd); if (stats.isDirectory()) { filePaths.push(...getFilePathsInDirectory(pathToAdd)); } else if (stats.isFile()) { filePaths.push(pathToAdd); } } return filePaths; } /** * Returns an object in the form expected by `server.tool` */ export function createToolTextContent(content: string): CallToolResult { return { content: [ { type: "text", text: content, }, ], }; } /** * Returns strucutred content expected by `server.tool` * The generic type T allows for type safety. Set T to the output schema of the tool, and your content will be type checked */ export function createToolStructuredContent< T extends { [key: string]: unknown } = { [key: string]: unknown }, >(content: T): CallToolResult { return { content: [ { type: "text", text: JSON.stringify(content), }, ], structuredContent: content, }; } /** * Recursively removes fields with null values from a JavaScript object. * If a nested object becomes empty after removing nulls, it will also be removed. * * @param {unknown} obj The object or array to clean. * @returns {object | unknown[] | undefined} The cleaned object/array, or undefined if the input was null/undefined or an empty object/array resulted. */ export function removeNullFields(obj: unknown): object | unknown[] | undefined { if (obj === null || obj === undefined) { return undefined; } if (Array.isArray(obj)) { const cleanedArray: unknown[] = []; for (const item of obj) { const cleanedItem = removeNullFields(item); if (cleanedItem !== undefined) { cleanedArray.push(cleanedItem); } } return cleanedArray.length > 0 ? cleanedArray : undefined; } if (typeof obj !== "object") { return obj as any; // Cast to any for primitive types } const cleanedObject: { [key: string]: unknown } = {}; for (const key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { const value = (obj as { [key: string]: unknown })[key]; if (value === null) { continue; } if (typeof value === "object") { const cleanedValue = removeNullFields(value); if (cleanedValue !== undefined) { cleanedObject[key] = cleanedValue; } } else { cleanedObject[key] = value; } } } return Object.keys(cleanedObject).length > 0 ? cleanedObject : undefined; } export function filterIncludedFields(obj: any, fieldsToInclude: string[]): any { if (!fieldsToInclude || fieldsToInclude.length === 0) { return obj; } if (Array.isArray(obj)) { return obj .map(item => filterIncludedFields(item, fieldsToInclude)) .filter(item => { if (item === undefined || item === null) { return false; } if (Array.isArray(item)) { return item.length > 0; } if (typeof item === "object") { return Object.keys(item).length > 0; } // Keep primitives return true; }); } if (typeof obj === "object" && obj !== null) { const newObj: any = {}; for (const key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { if (fieldsToInclude.includes(key)) { newObj[key] = obj[key]; } else { const result = filterIncludedFields(obj[key], fieldsToInclude); if (result !== undefined && result !== null) { if (Array.isArray(result)) { if (result.length > 0) { newObj[key] = result; } } else if (typeof result === "object") { if (Object.keys(result).length > 0) { newObj[key] = result; } } else { newObj[key] = result; } } } } } return Object.keys(newObj).length > 0 ? newObj : undefined; } return undefined; } /** * Formats a timestamp in milliseconds to a human-readable date string * Format: "February 24, 2025 at 3:23 PM" * * @param timestampMs - Timestamp in milliseconds * @param timeZone - Optional IANA timezone string (defaults to "America/Los_Angeles") * @returns Formatted date string */ export function formatTimestamp(timestampMs: number, timeZone?: string): string { return DateTime.fromMillis(timestampMs) .setZone(timeZone || "America/Los_Angeles") .toFormat("MMMM d, yyyy 'at' h:mm:ss a", { locale: "en-US", }); }