@telos.ready/mcp 1.7.0 → 1.9.0

package/build/index.js

@@ -3,6 +3,8 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import axios from "axios";
+import * as fs from "fs";
+import * as path from "path";
 // Configuration
 const DEFAULT_TELOS_BASE_URL = "https://go.telosready.com";
 // Create server instance
@@ -625,6 +627,122 @@ server.tool("raise-ticket", "Creates a new ticket and returns information that m
         };
     }
 });
+// Helper function to get MIME type from file extension
+function getMimeType(filename) {
+    const ext = path.extname(filename).toLowerCase();
+    const mimeTypes = {
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".gif": "image/gif",
+        ".webp": "image/webp",
+        ".bmp": "image/bmp",
+        ".svg": "image/svg+xml",
+        ".pdf": "application/pdf",
+        ".txt": "text/plain",
+        ".html": "text/html",
+        ".css": "text/css",
+        ".js": "application/javascript",
+        ".json": "application/json",
+        ".xml": "application/xml",
+        ".zip": "application/zip",
+    };
+    return mimeTypes[ext] || "application/octet-stream";
+}
+// Tool 15: Get Skill
+server.tool("get-skill", "Retrieves a skill workflow by code or name. Skills are reusable capabilities that AI agents can execute during workflow execution. Parameter accepts either the short skill code or full skill name.", {
+    applicationSlug: z
+        .string()
+        .describe('The application slug for the application context, which is a unique identifier string used to reference specific applications. The application slug is the ticket prefix, such as "TEL" or "XXX".'),
+    skillCodeOrName: z
+        .string()
+        .describe('The skill code or full skill name to retrieve.'),
+}, async ({ applicationSlug, skillCodeOrName }) => {
+    try {
+        const result = await telosClient.post("/mcp/get-skill", {
+            applicationSlug,
+            skillCodeOrName,
+        });
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: result.result }],
+            };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+            };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error getting skill ${skillCodeOrName} for application ${applicationSlug}: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// Tool 16: Attach Screenshot to Ticket
+server.tool("attach-screenshot", "Attaches a screenshot or image file from the local filesystem to a ticket. The tool reads the file from the provided path, encodes it, and uploads it as an attachment to the specified ticket. Supports common image formats (PNG, JPG, GIF, WebP).", {
+    ticketReference: z
+        .string()
+        .describe('The ticket reference for the ticket to attach the screenshot to, which is an uppercase alphabetical code followed by a number, such as "TEL037".'),
+    filename: z
+        .string()
+        .describe("The path to the screenshot file on the local filesystem. This should be an absolute path or a path relative to the current working directory."),
+}, async ({ ticketReference, filename }) => {
+    try {
+        // Validate that the file exists
+        if (!fs.existsSync(filename)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: File not found at path: ${filename}`,
+                    },
+                ],
+            };
+        }
+        // Read the file from the local filesystem
+        const fileBuffer = fs.readFileSync(filename);
+        // Encode file content as base64
+        const base64Content = fileBuffer.toString("base64");
+        // Get the filename without path for display
+        const displayFilename = path.basename(filename);
+        // Detect content type from file extension
+        const contentType = getMimeType(filename);
+        // Send to MCPController
+        const result = await telosClient.post("/mcp/attach-screenshot", {
+            ticketReference,
+            base64Content,
+            filename: displayFilename,
+            contentType,
+        });
+        if (result.success) {
+            return {
+                content: [{ type: "text", text: result.result }],
+            };
+        }
+        else {
+            return {
+                content: [{ type: "text", text: `Error: ${result.error}` }],
+            };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error attaching screenshot to ticket ${ticketReference}: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
 async function main() {
     try {
         // Initialize transport first
@@ -637,7 +755,7 @@ async function main() {
         await server.connect(transport);
         // Log success message
         console.error("✅ Telos MCP Server running on stdio");
-        console.error("Available tools: ask-question, search-documentation, add-ticket-comment, add-documentation, get-ticket-details, start-ticket, get-next-task, get-git-branch-for-ticket, mark-ticket-as-blocked, update-action-item, get-resource-list, get-resource-details, answer-question, raise-ticket");
+        console.error("Available tools: ask-question, search-documentation, add-ticket-comment, add-documentation, get-ticket-details, start-ticket, get-next-task, get-git-branch-for-ticket, mark-ticket-as-blocked, update-action-item, get-resource-list, get-resource-details, answer-question, raise-ticket, get-skill, attach-screenshot");
         // Test connection in background without blocking or exiting
         // This is non-critical and should not cause the server to exit
         setImmediate(async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telos.ready/mcp",
-  "version": "1.7.0",
+  "version": "1.9.0",
   "description": "Telos MCP server for managing tickets and project tasks",
   "main": "build/index.js",
   "type": "module",