@pschroee/redmine-mcp 0.5.7 → 0.5.10

package/dist/formatters/index.d.ts

@@ -7,7 +7,7 @@ export { formatWikiPage, formatWikiPageList } from "./wiki.js";
 export { formatVersion, formatVersionList } from "./version.js";
 export { formatTimeEntry, formatTimeEntryList } from "./time.js";
 export { formatGroup, formatGroupList } from "./group.js";
-export { formatTrackerList, formatStatusList, formatCategoryList, formatPriorityList, formatActivityList, formatRoleList, formatRole, formatCategory, formatCustomFieldList, formatQueryList, formatDocumentCategoryList, } from "./metadata.js";
+export { formatTrackerList, formatStatusList, formatCategoryList, formatPriorityList, formatActivityList, formatRoleList, formatRole, formatCategory, formatCustomFieldList, formatQueryList, formatDocumentCategoryList, type ProjectLookup, } from "./metadata.js";
 export { formatRelation, formatRelationList } from "./relation.js";
 export { formatAttachment, formatFileList } from "./file.js";
 export { formatMembership, formatMembershipList } from "./membership.js";

package/dist/formatters/metadata.d.ts

@@ -124,10 +124,14 @@ export declare function formatCategory(response: {
  * Format a list of custom fields as a Markdown table
  */
 export declare function formatCustomFieldList(response: RedmineCustomFieldsResponse): string;
+/**
+ * Project lookup map: ID -> name
+ */
+export type ProjectLookup = Record<number, string>;
 /**
  * Format a list of saved queries as a Markdown table
  */
-export declare function formatQueryList(response: RedmineQueriesResponse): string;
+export declare function formatQueryList(response: RedmineQueriesResponse, projectLookup?: ProjectLookup): string;
 /**
  * Format a list of document categories as a Markdown table
  */

package/dist/formatters/metadata.js

@@ -176,7 +176,7 @@ export function formatCustomFieldList(response) {
 /**
  * Format a list of saved queries as a Markdown table
  */
-export function formatQueryList(response) {
+export function formatQueryList(response, projectLookup = {}) {
     const queries = response.queries;
     if (queries.length === 0) {
         return "No queries found.";
@@ -188,7 +188,11 @@ export function formatQueryList(response) {
     lines.push("|----|------|---------|------------|");
     for (const query of queries) {
         const visibility = query.is_public ? "Public" : "Private";
-        const project = query.project_id ? `#${query.project_id}` : "Global";
+        let project = "Global";
+        if (query.project_id) {
+            const projectName = projectLookup[query.project_id];
+            project = projectName ? `${projectName} (${query.project_id})` : `#${query.project_id}`;
+        }
         lines.push(`| ${query.id} | ${query.name} | ${project} | ${visibility} |`);
     }
     return lines.join("\n");

package/dist/redmine/client.d.ts

@@ -230,9 +230,7 @@ export declare class RedmineClient {
     }>>;
     deleteIssueCategory(id: number, reassignToId?: number): Promise<RedmineResult<void>>;
     listCustomFields(): Promise<RedmineResult<RedmineCustomFieldsResponse>>;
-    listQueries(params?: {
-        project_id?: string | number;
-    }): Promise<RedmineResult<RedmineQueriesResponse>>;
+    listQueries(): Promise<RedmineResult<RedmineQueriesResponse>>;
     search(params: {
         q: string;
         scope?: string;

package/dist/redmine/client.js

@@ -305,10 +305,7 @@ export class RedmineClient {
         return this.request("GET", "/custom_fields.json");
     }
     // ==================== QUERIES ====================
-    async listQueries(params) {
-        if (params?.project_id) {
-            return this.request("GET", `/projects/${params.project_id}/queries.json`);
-        }
+    async listQueries() {
         return this.request("GET", "/queries.json");
     }
     // ==================== SEARCH ====================

package/dist/tools/agile.js

@@ -5,7 +5,7 @@ export function registerAgileTools(server, client) {
     server.registerTool("list_agile_sprints", {
         description: "List all agile sprints for a project (requires redmine_agile plugin)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
         },
     }, async (params) => {
         const result = await client.listAgileSprints(params.project_id);
@@ -21,7 +21,7 @@ export function registerAgileTools(server, client) {
     server.registerTool("get_agile_sprint", {
         description: "Get details of a specific agile sprint (requires redmine_agile plugin)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             sprint_id: z.number().describe("The sprint ID"),
         },
     }, async (params) => {
@@ -38,7 +38,7 @@ export function registerAgileTools(server, client) {
     server.registerTool("create_agile_sprint", {
         description: "Create a new agile sprint for a project (requires redmine_agile plugin)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             name: z.string().describe("Sprint name"),
             status: z.string().optional().describe("Sprint status: open, active, closed"),
             start_date: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -56,7 +56,7 @@ export function registerAgileTools(server, client) {
     server.registerTool("update_agile_sprint", {
         description: "Update an existing agile sprint (requires redmine_agile plugin)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             sprint_id: z.number().describe("The sprint ID to update"),
             name: z.string().optional().describe("New sprint name"),
             status: z.string().optional().describe("Sprint status: open, active, closed"),
@@ -75,7 +75,7 @@ export function registerAgileTools(server, client) {
     server.registerTool("delete_agile_sprint", {
         description: "Delete an agile sprint (requires redmine_agile plugin)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             sprint_id: z.number().describe("The sprint ID to delete"),
         },
     }, async (params) => {

package/dist/tools/core.js

@@ -5,7 +5,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("list_issues", {
         description: "List issues from Redmine with optional filters and sorting",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).optional().describe("Filter by project ID or identifier"),
+            project_id: z.string().optional().describe("Filter by project identifier"),
             tracker_id: z.number().optional().describe("Filter by tracker ID"),
             status_id: z.union([z.string(), z.number()]).optional().describe("Filter by status: 'open', 'closed', '*', or status ID"),
             assigned_to_id: z.union([z.number(), z.string()]).optional().describe("Filter by assigned user ID or 'me'"),
@@ -85,7 +85,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("create_issue", {
         description: "Create a new issue in Redmine",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             subject: z.string().describe("Issue subject/title"),
             description: z.string().optional().describe("Issue description (supports Textile/Markdown)"),
             tracker_id: z.number().optional().describe("Tracker ID (e.g., Bug, Feature)"),
@@ -117,7 +117,7 @@ export function registerCoreTools(server, client) {
             issue_id: z.number().describe("The issue ID to update"),
             subject: z.string().optional().describe("New subject/title"),
             description: z.string().optional().describe("New description"),
-            project_id: z.union([z.string(), z.number()]).optional().describe("Move to different project"),
+            project_id: z.string().optional().describe("Move to different project"),
             tracker_id: z.number().optional().describe("Change tracker"),
             status_id: z.number().optional().describe("Change status"),
             priority_id: z.number().optional().describe("Change priority"),
@@ -201,7 +201,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("get_project", {
         description: "Get details of a specific project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             include: z.string().optional().describe("Include: trackers, issue_categories, enabled_modules, time_entry_activities, issue_custom_fields"),
         },
     }, async (params) => {
@@ -240,7 +240,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("update_project", {
         description: "Update an existing project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             name: z.string().optional().describe("New project name"),
             description: z.string().optional().describe("New description"),
             homepage: z.string().optional().describe("New homepage URL"),
@@ -263,7 +263,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("delete_project", {
         description: "Delete a project permanently (requires admin privileges)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier to delete"),
+            project_id: z.string().describe("Project identifier to delete"),
         },
     }, async (params) => {
         const result = await client.deleteProject(params.project_id);
@@ -274,7 +274,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("archive_project", {
         description: "Archive a project (Redmine 5.0+)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier to archive"),
+            project_id: z.string().describe("Project identifier to archive"),
         },
     }, async (params) => {
         const result = await client.archiveProject(params.project_id);
@@ -285,7 +285,7 @@ export function registerCoreTools(server, client) {
     server.registerTool("unarchive_project", {
         description: "Unarchive a project (Redmine 5.0+)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier to unarchive"),
+            project_id: z.string().describe("Project identifier to unarchive"),
         },
     }, async (params) => {
         const result = await client.unarchiveProject(params.project_id);

package/dist/tools/files.js

@@ -49,7 +49,7 @@ export function registerFilesTools(server, client) {
     server.registerTool("list_project_files", {
         description: "List all files attached to a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
         },
     }, async (params) => {
         const result = await client.listProjectFiles(params.project_id);
@@ -65,7 +65,7 @@ export function registerFilesTools(server, client) {
     server.registerTool("upload_project_file", {
         description: "Attach an uploaded file to a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             token: z.string().describe("Upload token from upload_file"),
             version_id: z.number().optional().describe("Associated version ID"),
             filename: z.string().optional().describe("Override filename"),

package/dist/tools/memberships.js

@@ -4,7 +4,7 @@ export function registerMembershipsTools(server, client) {
     server.registerTool("list_project_memberships", {
         description: "List all memberships (users and groups) for a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             limit: z.number().optional().describe("Maximum results"),
             offset: z.number().optional().describe("Skip first N results"),
         },
@@ -39,7 +39,7 @@ export function registerMembershipsTools(server, client) {
     server.registerTool("create_project_membership", {
         description: "Add a user or group to a project with specified roles",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             user_id: z.number().describe("User ID or Group ID to add"),
             role_ids: z.array(z.number()).describe("Role IDs to assign (use list_roles to get IDs)"),
         },

package/dist/tools/metadata.js

@@ -33,7 +33,7 @@ export function registerMetadataTools(server, client) {
     server.registerTool("list_issue_categories", {
         description: "List all issue categories for a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
         },
     }, async (params) => {
         const result = await client.listIssueCategories(params.project_id);
@@ -65,7 +65,7 @@ export function registerMetadataTools(server, client) {
     server.registerTool("create_issue_category", {
         description: "Create a new issue category in a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             name: z.string().describe("Category name"),
             assigned_to_id: z.number().optional().describe("Default assignee user ID for this category"),
         },
@@ -120,17 +120,40 @@ export function registerMetadataTools(server, client) {
     server.registerTool("list_queries", {
         description: "List all saved issue queries (public and private)",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).optional().describe("Filter queries by project ID or identifier"),
+            project_id: z.string().optional().describe("Filter queries by project identifier"),
         },
     }, async (params) => {
-        const result = await client.listQueries(params.project_id ? { project_id: params.project_id } : undefined);
+        const result = await client.listQueries();
         if ("error" in result) {
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
             };
         }
+        // Build project lookup for resolving project names
+        const projectLookup = {};
+        const projectsResult = await client.listProjects({ limit: 100 });
+        let filterProjectId;
+        if (!("error" in projectsResult)) {
+            for (const project of projectsResult.projects) {
+                projectLookup[project.id] = project.name;
+                // Find the numeric ID for the filter project identifier
+                if (params.project_id && project.identifier === params.project_id) {
+                    filterProjectId = project.id;
+                }
+            }
+        }
+        // Filter queries by project if requested
+        let queries = result.queries;
+        if (params.project_id) {
+            if (filterProjectId === undefined) {
+                return {
+                    content: [{ type: "text", text: `Project "${params.project_id}" not found.` }],
+                };
+            }
+            queries = queries.filter(q => q.project_id === filterProjectId);
+        }
         return {
-            content: [{ type: "text", text: formatQueryList(result) }],
+            content: [{ type: "text", text: formatQueryList({ queries }, projectLookup) }],
         };
     });
 }

package/dist/tools/time.js

@@ -4,7 +4,7 @@ export function registerTimeTools(server, client) {
     server.registerTool("list_time_entries", {
         description: "List time entries with optional filters",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).optional().describe("Filter by project ID or identifier"),
+            project_id: z.string().optional().describe("Filter by project identifier"),
             user_id: z.union([z.number(), z.string()]).optional().describe("Filter by user ID or 'me'"),
             spent_on: z.string().optional().describe("Filter by exact date (YYYY-MM-DD)"),
             from: z.string().optional().describe("Filter from date (YYYY-MM-DD)"),
@@ -43,7 +43,7 @@ export function registerTimeTools(server, client) {
         description: "Log time on an issue or project",
         inputSchema: {
             issue_id: z.number().optional().describe("Issue ID to log time on (either issue_id or project_id required)"),
-            project_id: z.union([z.string(), z.number()]).optional().describe("Project ID to log time on (either issue_id or project_id required)"),
+            project_id: z.string().optional().describe("Project identifier to log time on (either issue_id or project_id required)"),
             hours: z.number().describe("Number of hours spent"),
             activity_id: z.number().optional().describe("Activity ID (use list_time_entry_activities to get IDs)"),
             spent_on: z.string().optional().describe("Date spent (YYYY-MM-DD, defaults to today)"),

package/dist/tools/wiki.js

@@ -4,7 +4,7 @@ export function registerWikiTools(server, client) {
     server.registerTool("list_wiki_pages", {
         description: "List all wiki pages in a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
         },
     }, async (params) => {
         const result = await client.listWikiPages(params.project_id);
@@ -20,7 +20,7 @@ export function registerWikiTools(server, client) {
     server.registerTool("get_wiki_page", {
         description: "Get content of a specific wiki page",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             page_name: z.string().describe("Wiki page name/title"),
             version: z.number().optional().describe("Specific version number to retrieve"),
             include: z.string().optional().describe("Include: attachments"),
@@ -42,7 +42,7 @@ export function registerWikiTools(server, client) {
     server.registerTool("create_wiki_page", {
         description: "Create a new wiki page in a project",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             page_name: z.string().describe("Wiki page name/title (used in URL)"),
             text: z.string().describe("Page content (supports Textile/Markdown)"),
             comments: z.string().optional().describe("Edit comment for version history"),
@@ -58,7 +58,7 @@ export function registerWikiTools(server, client) {
     server.registerTool("update_wiki_page", {
         description: "Update an existing wiki page",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             page_name: z.string().describe("Wiki page name/title"),
             text: z.string().describe("New page content"),
             comments: z.string().optional().describe("Edit comment for version history"),
@@ -74,7 +74,7 @@ export function registerWikiTools(server, client) {
     server.registerTool("delete_wiki_page", {
         description: "Delete a wiki page and all its history",
         inputSchema: {
-            project_id: z.union([z.string(), z.number()]).describe("Project ID or identifier"),
+            project_id: z.string().describe("Project identifier"),
             page_name: z.string().describe("Wiki page name/title to delete"),
         },
     }, async (params) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pschroee/redmine-mcp",
-  "version": "0.5.7",
+  "version": "0.5.10",
   "description": "MCP server for Redmine - full API access with configurable tool groups",
   "type": "module",
   "bin": {