@dpesch/mantisbt-mcp-server 1.18.0 → 1.18.1

package/CHANGELOG.md

@@ -11,6 +11,15 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [1.18.1] – 2026-11-10
+
+### Fixed
+
+- `get_project` and `get_project_versions`: `obsolete: true` returned no obsolete versions, and `inherit: true` no versions of parent projects (#8614). Without the IDs of obsolete versions, `update_version` could not reach them. The cause lies in MantisBT: the REST handler of `GET /projects/{id}/versions` drops these query parameters, so the endpoint always returns the project's own, active versions (known upstream as [mantisbt #34578](https://mantisbt.org/bugs/view.php?id=34578), unfixed as of MantisBT 2.28.4; fix proposed in [mantisbt PR #2313](https://github.com/mantisbt/mantisbt/pull/2313)). With `obsolete` or `inherit` set, the server now also reads `GET /projects`, which embeds every version of a project and gives the project hierarchy; without `inherit`, versions of parent projects are left out — unless the API user cannot see the parent project, in which case they cannot be told apart and stay in. The metadata cache (`get_metadata`) and the `mantis://projects/{id}` resource held the same gap and now contain obsolete and inherited versions too; refresh an existing cache with `get_metadata(refresh: true)`. The cache sync now takes the versions from `GET /projects` and no longer sends one `/versions` request per project. Without either parameter, `get_project` and `get_project_versions` behave as before and make no extra request.
+- `list_projects`, `get_project` and the `mantis://projects` resources never returned `subprojects`, although `get_project` lists the field (#8616). MantisBT sends it in camelCase as `subProjects`, which the server did not read. `subprojects` now holds the direct subprojects as `{ id, name }` references, the form MantisBT provides; projects without subprojects keep omitting the field. Refresh an existing metadata cache with `get_metadata(refresh: true)`.
+
+---
+
 ## [1.18.0] – 2026-11-09
 
 ### Deprecated

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.18.0",
-  "commit": "65fcaba",
-  "built_at": "2026-11-09T13:22:17.570Z"
+  "version": "1.18.1",
+  "commit": "53e8d2f",
+  "built_at": "2026-11-10T20:19:47.616Z"
 }

package/dist/resources/index.js

@@ -1,6 +1,7 @@
 import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { fetchIssueEnums } from '../tools/config.js';
 import { normalizeProject, stripAllProjectsPrefix } from '../tools/metadata.js';
+import { fetchProjectVersions } from '../versions.js';
 function jsonResource(uri, data) {
     return {
         contents: [{ uri: uri.href, mimeType: 'application/json', text: JSON.stringify(data) }],
@@ -56,15 +57,15 @@ export function registerResources(server, client, cache, testEnvironment = false
             categories = meta?.categories ?? [];
         }
         else {
-            const [projectResult, usersResult, versionsResult] = await Promise.all([
+            const [projectResult, usersResult, fetchedVersions] = await Promise.all([
                 client.get(`projects/${numId}`),
                 client.get(`projects/${numId}/users`),
-                client.get(`projects/${numId}/versions`, { obsolete: 1, inherit: 1 }),
+                fetchProjectVersions(client, numId, { obsolete: true, inherit: true }),
             ]);
             const raw = projectResult.projects?.[0];
             project = raw ? normalizeProject(raw) : undefined;
             users = usersResult.users ?? [];
-            versions = versionsResult.versions ?? [];
+            versions = fetchedVersions;
             categories = stripAllProjectsPrefix(raw?.categories ?? []);
         }
         if (!project) {

package/dist/tools/metadata.js

@@ -4,6 +4,7 @@ import { getVersionHint } from '../version-hint.js';
 import { ALL_PROJECTS_PREFIX } from '../constants.js';
 import { deprecationNote } from '../deprecation.js';
 import { fetchIssueEnumsWithCache } from './config.js';
+import { collectVersions } from '../versions.js';
 // Fields MantisBT strips from issue responses when the array is empty.
 // They are always valid 'select' values even if absent in a sample issue.
 const EMPTY_STRIPPED_FIELDS = [
@@ -108,28 +109,42 @@ export function normalizeProject(p) {
         ...(p.enabled !== undefined && { enabled: p.enabled }),
         ...(p.view_state !== undefined && { view_state: normalizeIdName(p.view_state) }),
         ...(p.access_level !== undefined && { access_level: { id: p.access_level.id, label: p.access_level.label } }),
-        ...(p.subprojects !== undefined && { subprojects: p.subprojects.map(normalizeProject) }),
+        // MantisBT sends the direct subprojects as subProjects: [{ id, name }] (#8616)
+        ...(p.subProjects !== undefined && {
+            subprojects: p.subProjects.map((s) => ({ id: s.id, name: s.name })),
+        }),
     };
 }
 async function fetchAndCacheMetadata(client, cache) {
     // Fetch all projects
     const projectResult = await client.get('projects');
-    const projects = (projectResult.projects ?? []).map(normalizeProject);
+    const rawProjects = projectResult.projects ?? [];
+    const projects = rawProjects.map(normalizeProject);
     const byProject = {};
+    // GET /projects embeds every version of a project, obsolete ones included;
+    // /versions ignores obsolete and inherit (#8614) and is only asked when a
+    // project arrives without embedded versions.
+    const embedsVersions = new Set(rawProjects.filter(p => p.versions !== undefined).map(p => p.id));
     // For each project, fetch users, versions, categories in parallel
     await Promise.all(projects.map(async (project) => {
         const [usersResult, versionsResult, projectDetailResult] = await Promise.allSettled([
             client.get(`projects/${project.id}/users`),
-            client.get(`projects/${project.id}/versions`, { obsolete: 1, inherit: 1 }),
+            embedsVersions.has(project.id)
+                ? { versions: [] }
+                : client.get(`projects/${project.id}/versions`, { obsolete: 1, inherit: 1 }),
             // Categories are embedded in the project detail response — same source as get_project_categories
             client.get(`projects/${project.id}`),
         ]);
         const users = usersResult.status === 'fulfilled'
             ? (usersResult.value.users ?? [])
             : [];
-        const versions = versionsResult.status === 'fulfilled'
-            ? (versionsResult.value.versions ?? [])
-            : [];
+        const versions = collectVersions({
+            own: versionsResult.status === 'fulfilled' ? (versionsResult.value.versions ?? []) : [],
+            projects: rawProjects,
+            projectId: project.id,
+            obsolete: true,
+            inherit: true,
+        });
         const rawCategories = projectDetailResult.status === 'fulfilled'
             ? (projectDetailResult.value.projects?.[0]?.categories ?? [])
             : [];

package/dist/tools/projects.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { coerceBool } from '../coerce.js';
+import { fetchProjectVersions } from '../versions.js';
 import { getVersionHint } from '../version-hint.js';
 import { normalizeProject, stripAllProjectsPrefix } from './metadata.js';
 import { deprecationNote } from '../deprecation.js';
@@ -18,15 +19,6 @@ const matchMembers = (users, query) => {
 };
 const PROJECT_INCLUDES = ['categories', 'users', 'versions'];
 export function registerProjectTools(server, client, cache) {
-    async function fetchVersions(projectId, obsolete, inherit) {
-        const params = {};
-        if (obsolete)
-            params.obsolete = 1;
-        if (inherit)
-            params.inherit = 1;
-        const result = await client.get(`projects/${projectId}/versions`, params);
-        return result.versions ?? [];
-    }
     /**
      * Project users. The metadata cache has no access-level filter, so it is
      * used only when access_level is not given; otherwise the API filters.
@@ -49,7 +41,7 @@ export function registerProjectTools(server, client, cache) {
     // ---------------------------------------------------------------------------
     server.registerTool('get_project', {
         title: 'Get Project',
-        description: `Get one MantisBT project: its master data (id, name, description, status, enabled, view_state, access_level, subprojects) and, on request, its categories, users and versions in the same call.
+        description: `Get one MantisBT project: its master data (id, name, description, status, enabled, view_state, access_level, subprojects as id and name of the direct subprojects) and, on request, its categories, users and versions in the same call.
 
 - include: any of "categories", "users", "versions" (default: none — master data only).
 - categories: names come without the "[All Projects] " prefix, ready for create_issue / update_issue.
@@ -82,7 +74,7 @@ Users come from the local metadata cache when it is fresh and no access_level is
             const [projectResult, users, versions] = await Promise.all([
                 client.get(`projects/${project_id}`),
                 wants.has('users') ? fetchUsers(project_id, access_level) : undefined,
-                wants.has('versions') ? fetchVersions(project_id, obsolete, inherit) : undefined,
+                wants.has('versions') ? fetchProjectVersions(client, project_id, { obsolete, inherit }) : undefined,
             ]);
             const raw = projectResult.projects?.[0];
             if (!raw)
@@ -187,7 +179,7 @@ Prerequisites: obtain project_id from list_projects.`,
         },
     }, async ({ project_id, obsolete, inherit }) => {
         try {
-            const versions = await fetchVersions(project_id, obsolete, inherit);
+            const versions = await fetchProjectVersions(client, project_id, { obsolete, inherit });
             return {
                 content: [{ type: 'text', text: JSON.stringify(versions, null, 2) }],
             };

package/dist/versions.js

@@ -0,0 +1,82 @@
+/** All projects that have the given project as a direct or indirect subproject. */
+export function ancestorIds(projects, projectId) {
+    const parentsOf = new Map();
+    for (const project of projects) {
+        for (const sub of project.subProjects ?? []) {
+            const parents = parentsOf.get(sub.id);
+            if (parents)
+                parents.push(project.id);
+            else
+                parentsOf.set(sub.id, [project.id]);
+        }
+    }
+    const found = new Set();
+    const queue = [...(parentsOf.get(projectId) ?? [])];
+    while (queue.length > 0) {
+        const id = queue.shift();
+        if (id === projectId || found.has(id))
+            continue;
+        found.add(id);
+        queue.push(...(parentsOf.get(id) ?? []));
+    }
+    return [...found];
+}
+/** /versions omits a blank description; GET /projects always sends one. */
+function normalizeVersion(version) {
+    if (version.description === undefined || version.description.trim() !== '')
+        return version;
+    const { description: _blank, ...rest } = version;
+    return rest;
+}
+const timeOf = (version) => {
+    const time = version.timestamp ? Date.parse(version.timestamp) : NaN;
+    return Number.isNaN(time) ? -Infinity : time;
+};
+/**
+ * Combines the /versions response with the versions embedded in GET /projects.
+ * Should a MantisBT release honour the parameters, both sources overlap; the
+ * union by id keeps the result free of duplicates either way.
+ */
+export function collectVersions(input) {
+    const { own, projects, projectId, obsolete = false, inherit = false } = input;
+    const versionsById = new Map(projects.map(p => [p.id, p.versions ?? []]));
+    const versionsOf = (id) => versionsById.get(id) ?? [];
+    const parentVersions = ancestorIds(projects, projectId).flatMap(versionsOf);
+    const parentIds = new Set(parentVersions.map(version => version.id));
+    const byId = new Map();
+    for (const version of [own, versionsOf(projectId), inherit ? parentVersions : []].flat()) {
+        if (byId.has(version.id))
+            continue;
+        if (!inherit && parentIds.has(version.id))
+            continue;
+        if (!obsolete && version.obsolete)
+            continue;
+        byId.set(version.id, normalizeVersion(version));
+    }
+    return [...byId.values()].sort((a, b) => timeOf(b) - timeOf(a));
+}
+/**
+ * Versions of one project. Without obsolete/inherit the /versions endpoint is
+ * accurate on its own; otherwise GET /projects fills in what it drops.
+ */
+export async function fetchProjectVersions(client, projectId, { obsolete = false, inherit = false } = {}) {
+    const params = {};
+    if (obsolete)
+        params.obsolete = 1;
+    if (inherit)
+        params.inherit = 1;
+    const ownRequest = client.get(`projects/${projectId}/versions`, params);
+    if (!obsolete && !inherit)
+        return (await ownRequest).versions ?? [];
+    const [ownResult, projectsResult] = await Promise.all([
+        ownRequest,
+        client.get('projects'),
+    ]);
+    return collectVersions({
+        own: ownResult.versions ?? [],
+        projects: projectsResult.projects ?? [],
+        projectId,
+        obsolete,
+        inherit,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpesch/mantisbt-mcp-server",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "mcpName": "io.github.dpesch/mantisbt-mcp-server",
   "description": "MCP server for MantisBT REST API – read and manage bug tracker issues",
   "author": "Dominik Pesch",

package/server.json

@@ -3,12 +3,12 @@
   "name": "io.github.dpesch/mantisbt-mcp-server",
   "title": "MantisBT MCP Server",
   "description": "MantisBT MCP server – manage issues, notes, files, tags, and relationships. With semantic search.",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@dpesch/mantisbt-mcp-server",
-      "version": "1.18.0",
+      "version": "1.18.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"