@telos.ready/mcp 1.6.0 → 1.8.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
@@ -478,7 +480,7 @@ server.tool("get-resource-list", "Gets a list of resources for an application. R
     }
 });
 // Tool 12: Get Resource Details
-server.tool("get-resource-details", "Gets detailed information about a specific resource by name and group. Resource names can be identified by using get-resource-list. Special resources include: Application Map, Style Guide, Tech Patterns, Database Schema", {
+server.tool("get-resource-details", "Gets detailed information about a specific resource by name and group. Resource names can be identified by using get-resource-list. Special resources include: Application Map, Style Guide, Tech Patterns, Database Schema, User Guide", {
     applicationSlug: z
         .string()
         .describe('The application slug for the application you want to get resource details for, which is a unique identifier string used to reference specific applications. The application slug is the ticket prefix, such as "TEL" or "XXX".'),
@@ -555,6 +557,156 @@ server.tool("answer-question", "Answers a question that was previously asked wit
         };
     }
 });
+// Tool 14: Raise Ticket
+server.tool("raise-ticket", "Creates a new ticket and returns information that may be useful when implementing the ticket.  Tickets represent a unit-of-work that is being done for an application. After the ticket has been raised, comments can be added to the ticket using the add-ticket-comment tool.", {
+    applicationSlug: z
+        .string()
+        .describe('The application slug, such as "TEL".'),
+    title: z
+        .string()
+        .describe("The title of the ticket to create."),
+    description: z
+        .string()
+        .describe("The description of the ticket to create."),
+    parentTicketReference: z
+        .string()
+        .optional()
+        .describe('Optional parent ticket reference - if provided, the new ticket will be linked to the parent ticket as a child ticket. Format: TEL123'),
+    priority: z
+        .string()
+        .optional()
+        .describe("The priority of the ticket. Options: Urgent, High, Medium, Low, None. Defaults to Medium."),
+    credits: z
+        .string()
+        .optional()
+        .describe("The credits for the ticket. Set to 0 unless requested otherwise."),
+    stageName: z
+        .string()
+        .optional()
+        .describe("Optional name of the stage to assign the ticket to. Must match an active stage."),
+    workflowName: z
+        .string()
+        .optional()
+        .describe("Optional name of a workflow to execute when the ticket is created."),
+    ticketType: z
+        .string()
+        .optional()
+        .describe("The type of ticket. Options: SUPPORTREQUEST, DEVELOPMENT, BACKLOG, RECOMMENDATION, KNOWLEDGE. Defaults to DEVELOPMENT or inherits from parent."),
+}, async ({ applicationSlug, title, description, parentTicketReference, priority, credits, stageName, workflowName, ticketType, }) => {
+    try {
+        const result = await telosClient.post("/mcp/raise-ticket", {
+            applicationSlug,
+            title,
+            description,
+            parentTicketReference,
+            priority,
+            credits,
+            stageName,
+            workflowName,
+            ticketType,
+        });
+        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 creating ticket in application ${applicationSlug}: ${error.message}`,
+                },
+            ],
+        };
+    }
+});
+// 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: 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
@@ -567,7 +719,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");
+        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, 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.6.0",
+  "version": "1.8.0",
   "description": "Telos MCP server for managing tickets and project tasks",
   "main": "build/index.js",
   "type": "module",