@uarlouski/testrail-mcp-server 2.4.0 → 2.5.0

package/dist/index.js

@@ -25,7 +25,7 @@ if (!parseResult.success) {
 const { TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY, TESTRAIL_ENABLE_SHARED_STEPS, TESTRAIL_ENABLE_CASE_HISTORY, TESTRAIL_ALLOW_WRITE_OPERATIONS, TESTRAIL_ALLOW_READ_OPERATIONS, TESTRAIL_ALLOW_DELETE_OPERATIONS, TESTRAIL_ENABLE_DEPRECATED_TOOLS } = parseResult.data;
 const server = new McpServer({
     name: "TestRail MCP Server",
-    version: "2.4.0",
+    version: "2.5.0",
 });
 const client = new TestRailClient(TESTRAIL_INSTANCE_URL, TESTRAIL_USERNAME, TESTRAIL_API_KEY);
 const tools = getToolsToRegister({

package/dist/tools/cases/get_case_fields.js

@@ -67,7 +67,7 @@ export function mapToFieldSchema(field) {
     }
     return schema;
 }
-function isFieldForProject(field, projectId) {
+export function isFieldForProject(field, projectId) {
     const contexts = field.configs.map(c => c.context).filter(Boolean);
     if (contexts.length === 0)
         return true;

package/dist/tools/cases/index.js

@@ -5,7 +5,8 @@ import { updateCaseTool } from "./update_case.js";
 import { updateCasesTool } from "./update_cases.js";
 import { addCaseTool } from "./add_case.js";
 import { getCaseHistoryTool } from "./get_case_history.js";
-export { getCaseHistoryTool };
+import { resolveCaseFieldTool } from "./resolve_case_field.js";
+export { getCaseHistoryTool, resolveCaseFieldTool };
 export const casesTools = [
     getCaseTool,
     getCasesTool,
@@ -13,4 +14,5 @@ export const casesTools = [
     updateCaseTool,
     updateCasesTool,
     addCaseTool,
+    resolveCaseFieldTool,
 ];

package/dist/tools/cases/resolve_case_field.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { parseDropdownOptions } from "../../utils/mapper.js";
+import { isActive } from "../../utils/sanitizer.js";
+import { isFieldForProject } from "./get_case_fields.js";
+const parameters = {
+    project_id: z.number().describe("The ID of the project to resolve field values for"),
+    field_name: z.string().describe("The system name of the Multi-select field (e.g. 'custom_case_feature_tags')"),
+    refs: z.union([z.number(), z.array(z.number())]).describe("A single numeric ID or array of numeric IDs/references (e.g. [1, 55, 6] or 55) to resolve"),
+};
+const description = `
+Resolve numeric reference IDs of a Multi-select case field (type ID 12) into their textual values for a specific project.
+`;
+export const resolveCaseFieldTool = {
+    name: "resolve_case_field",
+    mode: "read",
+    description: description.trim(),
+    parameters,
+    handler: async ({ project_id, field_name, refs }, client) => {
+        const caseFields = await client.getCaseFields();
+        const activeFields = caseFields.filter(isActive);
+        const targetField = activeFields.find(f => f.system_name.toLowerCase() === field_name.toLowerCase());
+        if (!targetField) {
+            throw new Error(`Field '${field_name}' not found in active case fields.`);
+        }
+        if (targetField.type_id !== 12) {
+            throw new Error(`Field '${targetField.system_name}' is of type_id ${targetField.type_id}, but resolve_case_field only supports Multi-select fields (type_id: 12).`);
+        }
+        if (!isFieldForProject(targetField, project_id)) {
+            throw new Error(`Field '${targetField.system_name}' is not enabled for project ID ${project_id}.`);
+        }
+        const options = parseDropdownOptions(targetField, project_id);
+        const refList = Array.isArray(refs) ? refs : [refs];
+        const resolved = refList.map(ref => {
+            const val = options.get(String(ref)) ?? null;
+            return {
+                id: ref,
+                value: val,
+            };
+        });
+        return {
+            field_name: targetField.system_name,
+            resolved,
+        };
+    }
+};

package/dist/utils/mapper.js

@@ -42,15 +42,29 @@ export function processCustomFields(testCase, caseFields) {
 }
 /**
  * Parse dropdown options from field configs.
+ * If projectId is provided, prioritizes configuration specific to that project.
  * Format: "1, First\n2, Second\n3, Third"
  */
-export function parseDropdownOptions(field) {
+export function parseDropdownOptions(field, projectId) {
     const options = new Map();
-    for (const config of field.configs) {
+    let configsToParse = field.configs;
+    if (projectId !== undefined) {
+        const projectConfig = field.configs.find(c => c.context && !c.context.is_global && c.context.project_ids.includes(projectId));
+        if (projectConfig) {
+            configsToParse = [projectConfig];
+        }
+        else {
+            const globalConfig = field.configs.find(c => c.context?.is_global);
+            if (globalConfig) {
+                configsToParse = [globalConfig];
+            }
+        }
+    }
+    for (const config of configsToParse) {
         const items = config.options?.items;
         if (!items)
             continue;
-        const lines = items.split('\n');
+        const lines = items.split(/\r?\n/);
         for (const line of lines) {
             const commaIndex = line.indexOf(',');
             if (commaIndex > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uarlouski/testrail-mcp-server",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "mcpName": "io.github.uarlouski/testrail-mcp-server",
   "description": "Model Context Protocol (MCP) server for TestRail integration, enabling LLMs to fetch test cases and metadata.",
   "main": "dist/index.js",