@dpesch/mantisbt-mcp-server 1.11.0 → 1.13.0

package/docs/cookbook.md

@@ -4,6 +4,8 @@ Tool-oriented recipes for the MantisBT MCP server — each recipe shows exactly
 
 ---
 
+- [Connection setup](#connection-setup)
+  - [Connect to an installation without URL rewriting](#connect-to-an-installation-without-url-rewriting)
 - [Discovering your instance](#discovering-your-instance)
   - [Get all projects](#get-all-projects)
   - [Discover valid enum values (severity, status, priority)](#discover-valid-enum-values-severity-status-priority)
@@ -50,6 +52,10 @@ Tool-oriented recipes for the MantisBT MCP server — each recipe shows exactly
 - [Projects & Categories](#projects--categories)
   - [List project categories](#list-project-categories)
   - [Find a project member](#find-a-project-member)
+  - [Create a project version](#create-a-project-version)
+  - [Update a project version](#update-a-project-version)
+  - [Release a version and create the next bugfix placeholder](#release-a-version-and-create-the-next-bugfix-placeholder)
+  - [Delete a project version](#delete-a-project-version)
 - [Metadata](#metadata)
   - [Get a metadata summary](#get-a-metadata-summary)
   - [Get the full metadata cache](#get-the-full-metadata-cache)
@@ -72,6 +78,41 @@ Tool-oriented recipes for the MantisBT MCP server — each recipe shows exactly
 
 ---
 
+## Connection setup
+
+### Connect to an installation without URL rewriting
+
+Some MantisBT installations serve the REST API only through its front controller — typically Apache without `mod_rewrite`, or IIS without a rewrite module. There, `/api/rest/issues` returns 404 while `/api/rest/index.php/issues` works.
+
+**Option A — set the flag explicitly:**
+
+```json
+{
+  "env": {
+    "MANTIS_BASE_URL": "https://mantis.example.com",
+    "MANTIS_API_KEY": "your-api-token",
+    "MANTIS_USE_INDEX_PHP": "true"
+  }
+}
+```
+
+**Option B — paste the full REST URL and let the server detect it:**
+
+```json
+{
+  "env": {
+    "MANTIS_BASE_URL": "https://mantis.example.com/api/rest/index.php",
+    "MANTIS_API_KEY": "your-api-token"
+  }
+}
+```
+
+When `MANTIS_BASE_URL` ends with `/api/rest/index.php`, index.php routing is enabled automatically. An explicitly set `MANTIS_USE_INDEX_PHP` always wins over the detection — setting it to `false` alongside such a URL forces plain `/api/rest/` routing and logs a warning on stderr.
+
+**Verify:** call `get_mantis_version`. A successful response means the routing is correct.
+
+---
+
 ## Discovering your instance
 
 ### Get all projects
@@ -1564,6 +1605,167 @@ Searches project members by name, real name, or email. The search is case-insens
 
 ---
 
+### Create a project version
+
+Creates a new version in a MantisBT project. Without `timestamp`, MantisBT uses the current date. Version names must be unique within the project.
+
+> **Permission required:** `manage_project_threshold` (MantisBT default: manager).
+
+**Tool:** `create_version`
+
+**Parameters:**
+- `project_id` — numeric project ID
+- `name` — version name, e.g. `"2.0.0"`
+- `description` — _(optional)_ version description
+- `released` — _(optional)_ mark the version as released; default `false`
+- `obsolete` — _(optional)_ mark the version as obsolete; default `false`
+- `timestamp` — _(optional)_ version date as ISO 8601 string, e.g. `"2026-09-27"`
+
+**Request:**
+
+```json
+{
+  "project_id": 3,
+  "name": "2.0.0",
+  "description": "Major rewrite"
+}
+```
+
+**Response:**
+
+```json
+{
+  "id": 50,
+  "name": "2.0.0",
+  "description": "Major rewrite",
+  "released": false,
+  "obsolete": false,
+  "timestamp": "2026-09-27T00:00:00+00:00"
+}
+```
+
+---
+
+### Update a project version
+
+Updates an existing version of a MantisBT project. Only the fields you pass are changed; at least one field is required. Renaming a version also rewrites the `version`, `target_version`, and `fixed_in_version` fields of all issues that reference it (including subprojects with inherited versions).
+
+> **Permission required:** `manage_project_threshold` (MantisBT default: manager). Versions inherited from a parent project can only be changed via the parent's `project_id`.
+
+**Tool:** `update_version`
+
+**Parameters:**
+- `project_id` — numeric project ID
+- `version_id` — numeric version ID (use `get_project_versions` to discover)
+- `name` — _(optional)_ new version name (must be unique within the project)
+- `description` — _(optional)_ new version description
+- `released` — _(optional)_ released flag
+- `obsolete` — _(optional)_ obsolete flag
+- `timestamp` — _(optional)_ version date as ISO 8601 string
+
+**Request:** _(mark a version as obsolete)_
+
+```json
+{
+  "project_id": 3,
+  "version_id": 21,
+  "obsolete": true
+}
+```
+
+**Response:**
+
+```json
+{
+  "id": 21,
+  "name": "1.9.0",
+  "released": true,
+  "obsolete": true,
+  "timestamp": "2025-06-01T00:00:00+00:00"
+}
+```
+
+---
+
+### Release a version and create the next bugfix placeholder
+
+Marks a version as released (setting its date) and creates a follow-up version placeholder in the same call. The follow-up version name is used as-is — no automatic numbering. If the follow-up creation fails, the release stays in effect and the error is reported in `next_version_error`.
+
+> **Permission required:** `manage_project_threshold` (MantisBT default: manager). Versions inherited from a parent project can only be changed via the parent's `project_id`.
+
+**Tool:** `release_version`
+
+**Parameters:**
+- `project_id` — numeric project ID
+- `version_id` — numeric version ID of the version to release
+- `timestamp` — _(optional)_ release date as ISO 8601 string; default: now
+- `next_version` — _(optional)_ name of the follow-up version to create as an unreleased placeholder
+
+**Request:**
+
+```json
+{
+  "project_id": 3,
+  "version_id": 42,
+  "timestamp": "2026-09-27",
+  "next_version": "1.2.1"
+}
+```
+
+**Response:**
+
+```json
+{
+  "released": {
+    "id": 42,
+    "name": "1.2.0",
+    "released": true,
+    "obsolete": false,
+    "timestamp": "2026-09-27T00:00:00+00:00"
+  },
+  "next_version": {
+    "id": 43,
+    "name": "1.2.1",
+    "released": false,
+    "obsolete": false,
+    "timestamp": "2026-09-27T00:00:00+00:00"
+  }
+}
+```
+
+> **Note:** Setting `released=true` via `update_version` does not change the version date — use `release_version` when you want to set both in one step.
+
+---
+
+### Delete a project version
+
+Permanently deletes a version from a MantisBT project. This action is irreversible. MantisBT clears the `version`, `target_version`, and `fixed_in_version` fields of all issues that reference the deleted version. To retire a version without touching issues, use `update_version` with `obsolete=true` instead.
+
+> **Permission required:** `manage_project_threshold` (MantisBT default: manager). Versions inherited from a parent project can only be deleted via the parent's `project_id`.
+
+**Tool:** `delete_version`
+
+**Parameters:**
+- `project_id` — numeric project ID
+- `version_id` — numeric version ID
+
+**Request:**
+
+```json
+{
+  "project_id": 3,
+  "version_id": 7
+}
+```
+
+**Response:**
+
+```
+Version 7 deleted successfully.
+```
+
+---
+
 ## Metadata
 
 ### Get a metadata summary

package/docs/examples.de.md

@@ -1,6 +1,6 @@
 # Anwendungsbeispiele
 
-Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der MCP-Server verbunden ist. Einfach in natürlicher Sprache fragen — keine Tool-Namen oder Parameter erforderlich. Für exakte Tool-Aufrufe und Parameter siehe das [Cookbook](cookbook.de.md).
+Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der MCP-Server verbunden ist. Einfach in natürlicher Sprache fragen – keine Tool-Namen oder Parameter erforderlich. Für exakte Tool-Aufrufe und Parameter siehe das [Cookbook](cookbook.de.md).
 
 ---
 
@@ -16,7 +16,7 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 > »Was ist der Status von Issue #1042?«
 
-> »Zeige mir von Issue #1042 nur Titel, Status und Bearbeiter — ohne die vollständige Beschreibung und Notizen.«
+> »Zeige mir von Issue #1042 nur Titel, Status und Bearbeiter – ohne die vollständige Beschreibung und Notizen.«
 
 > »Zeige mir alle Issues, die jsmith diesen Monat gemeldet hat.«
 
@@ -28,7 +28,7 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 > »Erstelle einen Bug-Report: Auf der Checkout-Seite wird die Bestellung doppelt abgeschickt, wenn man zweimal auf 'Bestellen' klickt. Kategorie: Shop, Schweregrad: schwerwiegend.«
 
-> »Öffne ein neues Issue im API-Projekt — der Token-Refresh-Endpoint gibt 500 zurück, wenn das Refresh-Token abgelaufen ist. Dem Backend-Team zuweisen.«
+> »Öffne ein neues Issue im API-Projekt – der Token-Refresh-Endpoint gibt 500 zurück, wenn das Refresh-Token abgelaufen ist. Dem Backend-Team zuweisen.«
 
 > »Erstelle einen Feature-Request im Frontend-Projekt für einen Dunkelmodus in den Benutzereinstellungen. Niedrige Priorität, kein Fälligkeitsdatum.«
 
@@ -76,7 +76,7 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 > »Verknüpfe #901 und #902 als verwandte Issues.«
 
-> »Issue #1100 blockiert #1101 — bitte diese Beziehung anlegen.« 
+> »Issue #1100 blockiert #1101 – bitte diese Beziehung anlegen.« 
 > *(Richtung ist entscheidend: #1100 ist das blockierende Issue)*
 
 ---
@@ -107,6 +107,18 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 ---
 
+### Projektversionen verwalten
+
+> »Erstelle Version 2.0.0 in Projekt 3.«
+
+> »Markiere Version 1.4.0 von Projekt 5 als veröffentlicht und lege 1.4.1 als nächste Version an.«
+
+> »Markiere Version 1.0 im Backend-Projekt als veraltet.«
+
+> »Lösche Version 0.9-test aus Projekt 3.«
+
+---
+
 ### Triage und Auswertung
 
 > »Gib mir einen Überblick über alle kritischen und dringenden offenen Issues in allen Projekten.«
@@ -123,7 +135,7 @@ Praktische Beispiele für die Interaktion mit MantisBT über Claude, sobald der
 
 ## Geführte Prompt-Workflows
 
-Der Server enthält Prompt-Templates, die Claude durch strukturierte Arbeitsabläufe führen — Tool-Namen oder Parameter müssen nicht manuell angegeben werden. Die Prompts werden aus einem MCP-fähigen Client beim Namen aufgerufen.
+Der Server enthält Prompt-Templates, die Claude durch strukturierte Arbeitsabläufe führen – Tool-Namen oder Parameter müssen nicht manuell angegeben werden. Die Prompts werden aus einem MCP-fähigen Client beim Namen aufgerufen.
 
 ### Issues über Prompt-Templates anlegen
 
@@ -141,7 +153,7 @@ Der Server enthält Prompt-Templates, die Claude durch strukturierte Arbeitsabl
 
 ## Semantische Suche
 
-Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzelne Schlüsselwörter. Sie findet konzeptionell verwandte Issues, auch wenn die genaue Formulierung abweicht. Aktivierung mit `MANTIS_SEARCH_ENABLED=true`.
+Die semantische Suche versteht die *Bedeutung* deiner Frage – nicht nur einzelne Schlüsselwörter. Sie findet konzeptionell verwandte Issues, auch wenn die genaue Formulierung abweicht. Aktivierung mit `MANTIS_SEARCH_ENABLED=true`.
 
 ### Duplikaterkennung vor dem Anlegen
 
@@ -155,7 +167,7 @@ Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzel
 
 ### Thematische Übersichten
 
-> »Zeig mir relevante Issues rund um die Zahlungsabwicklung — projektübergreifend.«
+> »Zeig mir relevante Issues rund um die Zahlungsabwicklung – projektübergreifend.«
 
 > »Zeig mir Beispiele für gemeldete E-Mail-Zustellungsfehler.«
 
@@ -171,15 +183,15 @@ Die semantische Suche versteht die *Bedeutung* deiner Frage — nicht nur einzel
 
 > »Suche nach 'Rechnungsexport' und markiere die relevanten Ausschnitte in Titel und Beschreibung.«
 
-Exakte Parameter und Response-Shape: [Cookbook — Suche mit Keyword-Highlights](cookbook.de.md#suche-mit-keyword-highlights).
+Exakte Parameter und Response-Shape: [Cookbook – Suche mit Keyword-Highlights](cookbook.de.md#suche-mit-keyword-highlights).
 
 ---
 
 ### Unscharfe / terminologieunabhängige Suche
 
-> »Finde Issues zu 'doppelten Einträgen' — sie könnten auch als 'zweimal angezeigt', 'doppelte Datensätze' oder 'Phantom-Zeilen' beschrieben sein.«
+> »Finde Issues zu 'doppelten Einträgen' – sie könnten auch als 'zweimal angezeigt', 'doppelte Datensätze' oder 'Phantom-Zeilen' beschrieben sein.«
 
-> »Suche nach authentifizierungsbezogenen Issues — die Berichte verwenden möglicherweise 'Login', 'Anmeldung', 'Token', 'Session' oder 'Auth'.«
+> »Suche nach authentifizierungsbezogenen Issues – die Berichte verwenden möglicherweise 'Login', 'Anmeldung', 'Token', 'Session' oder 'Auth'.«
 
 ---
 
@@ -203,7 +215,7 @@ Exakte Parameter und Response-Shape: [Cookbook — Suche mit Keyword-Highlights]
 
 ## Ressourcen
 
-MCP-Ressourcen sind URI-adressierbare, schreibgeschützte Daten, die Clients direkt per URI abrufen können — kein Tool-Aufruf nötig. Die Ressourcen-Unterstützung variiert je nach Client; wenn der verwendete Client keine Ressourcen unterstützt, das entsprechende Tool als Alternative verwenden.
+MCP-Ressourcen sind URI-adressierbare, schreibgeschützte Daten, die Clients direkt per URI abrufen können – kein Tool-Aufruf nötig. Die Ressourcen-Unterstützung variiert je nach Client; wenn der verwendete Client keine Ressourcen unterstützt, das entsprechende Tool als Alternative verwenden.
 
 ### Server-Zustand über Ressourcen abrufen
 

package/docs/examples.md

@@ -107,6 +107,18 @@ Practical examples of how to interact with MantisBT through Claude once the MCP
 
 ---
 
+### Managing project versions
+
+> "Create version 2.0.0 in project 3."
+
+> "Mark version 1.4.0 of project 5 as released and create 1.4.1 as the next version."
+
+> "Mark version 1.0 as obsolete in the Backend project."
+
+> "Delete version 0.9-test from project 3."
+
+---
+
 ### Triage and reporting
 
 > "Give me an overview of all critical and urgent open issues across all projects."

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpesch/mantisbt-mcp-server",
-  "version": "1.11.0",
+  "version": "1.13.0",
   "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.11.0",
+  "version": "1.13.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@dpesch/mantisbt-mcp-server",
-      "version": "1.11.0",
+      "version": "1.13.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -29,6 +29,14 @@
           "isSecret": true,
           "format": "string"
         },
+        {
+          "name": "MANTIS_USE_INDEX_PHP",
+          "description": "Use /api/rest/index.php/ for MantisBT installations without URL rewriting. Detected automatically when MANTIS_BASE_URL ends with /api/rest/index.php",
+          "isRequired": false,
+          "isSecret": false,
+          "format": "boolean",
+          "default": "false"
+        },
         {
           "name": "MANTIS_CACHE_DIR",
           "description": "Directory for the metadata cache. Defaults to ~/.cache/mantisbt-mcp",