@dpesch/mantisbt-mcp-server 1.4.0 → 1.5.1

package/.env.local

@@ -0,0 +1,3 @@
+MANTIS_BASE_URL=https://mantis.dev.11com7.de
+MANTIS_API_KEY=3vhKDwxVavmCzRUR7Cp0Lk7F8E4dha6n
+MANTIS_SEARCH_ENABLED=true

package/CHANGELOG.md

@@ -7,6 +7,24 @@ This project adheres to [Semantic Versioning](https://semver.org/).
 
 ---
 
+## [1.5.1] – 2026-03-17
+
+### Fixed
+- Semantic search: ONNX thread pool now defaults to 1 thread (`intra_op_num_threads=1`) instead of auto-detecting all available CPU cores. On WSL and multi-core machines the unrestricted default caused CPU saturation (700%+ CPU, 12 GB VM) during the initial index build. The number of threads is configurable via the new `MANTIS_SEARCH_THREADS` environment variable (default: `1`). `inter_op_num_threads` is always kept at 1 because Transformer model graphs are sequential and inter-op parallelism provides no benefit.
+
+---
+
+## [1.5.0] – 2026-03-17
+
+### Added
+- `create_issue`: always returns the complete issue object. Older MantisBT versions returned only `{ id: N }` on `POST /issues`; the tool now detects this and performs an automatic `GET /issues/{id}` to retrieve the full issue. If that fetch fails the minimal object is returned instead (the issue was already created).
+- `get_issue_enums`: each entry now includes an optional `canonical_name` field containing the standard English API name (e.g. `"minor"`, `"block"`) when the returned `name` differs from it. This occurs on localized MantisBT installations where enum values have been customized at the database level (e.g. `name: "kleinerer Fehler"` instead of `"minor"`). The field is omitted when `name` already matches the canonical value and for custom entries without a known canonical name. Available for all five enum groups (severity, status, priority, resolution, reproducibility).
+- `create_issue`: new optional `handler` parameter accepts a username string as alternative to `handler_id`. The server resolves the name against the project members list (from the metadata cache when available, otherwise via a direct API call). If the username is not found, an error is returned with a list of available users.
+- `add_relationship`: new optional `type_name` parameter accepts string names as alternative to the numeric `type_id` (e.g. `"related_to"`, `"duplicate_of"`, `"depends_on"`, `"blocks"`). Dash variants (`"related-to"`) are also accepted. `type_id` becomes optional — at least one of the two must be provided; `type_id` takes precedence when both are given.
+- `search_issues`: new optional `select` parameter. When provided, each matching issue is fetched from MantisBT and the response is enriched with the requested fields (comma-separated, e.g. `"id,summary,status,handler,priority"`). Without `select` the behaviour is unchanged — only `id` and `score` are returned. `id` and `score` are always included regardless of the `select` value. If an individual issue fetch fails, that result falls back silently to `{id, score}`.
+
+---
+
 ## [1.4.0] – 2026-03-17
 
 ### Added

package/README.de.md

@@ -73,6 +73,7 @@ npm run build
 | `MANTIS_SEARCH_BACKEND` | – | `vectra` | Vektorspeicher: `vectra` (reines JS) oder `sqlite-vec` (manuelle Installation erforderlich) |
 | `MANTIS_SEARCH_DIR` | – | `{MANTIS_CACHE_DIR}/search` | Verzeichnis für den Suchindex |
 | `MANTIS_SEARCH_MODEL` | – | `Xenova/paraphrase-multilingual-MiniLM-L12-v2` | Embedding-Modell (wird beim ersten Start einmalig heruntergeladen, ~80 MB) |
+| `MANTIS_SEARCH_THREADS` | – | `1` | Anzahl der ONNX-Intra-Op-Threads für das Embedding-Modell. Standard ist 1, um CPU-Sättigung auf Mehrkernsystemen und in WSL zu verhindern. Nur erhöhen, wenn die Indexierungsgeschwindigkeit kritisch ist und der Host ausschließlich für diese Last vorgesehen ist. |
 
 ### Config-Datei (Fallback)
 
@@ -93,7 +94,7 @@ Falls keine Umgebungsvariablen gesetzt sind, wird `~/.claude/mantis.json` ausgel
 |---|---|
 | `get_issue` | Ein Issue anhand seiner ID abrufen |
 | `list_issues` | Issues nach Projekt, Status, Autor u.v.m. filtern; optionales `select` für Feldprojektion und `status` für clientseitige Statusfilterung |
-| `create_issue` | Neues Issue anlegen |
+| `create_issue` | Neues Issue anlegen; optionaler `handler`-Parameter akzeptiert einen Benutzernamen als Alternative zu `handler_id` (wird gegen die Projektmitglieder aufgelöst) |
 | `update_issue` | Bestehendes Issue bearbeiten |
 | `delete_issue` | Issue löschen |
 
@@ -116,7 +117,7 @@ Falls keine Umgebungsvariablen gesetzt sind, wird `~/.claude/mantis.json` ausgel
 
 | Tool | Beschreibung |
 |---|---|
-| `add_relationship` | Beziehung zwischen zwei Issues erstellen |
+| `add_relationship` | Beziehung zwischen zwei Issues erstellen; optionaler `type_name`-Parameter akzeptiert einen String-Namen (z.B. `"related_to"`, `"duplicate_of"`) als Alternative zur numerischen `type_id` |
 | `remove_relationship` | Beziehung von einem Issue entfernen (die `id` aus dem Beziehungsobjekt verwenden, nicht die type-ID) |
 
 ### Beobachter
@@ -157,7 +158,7 @@ Aktivierung mit `MANTIS_SEARCH_ENABLED=true`.
 
 | Tool | Beschreibung |
 |---|---|
-| `search_issues` | Natürlichsprachige Suche über alle indizierten Issues – liefert Top-N-Ergebnisse mit Cosine-Similarity-Score |
+| `search_issues` | Natürlichsprachige Suche über alle indizierten Issues – liefert Top-N-Ergebnisse mit Cosine-Similarity-Score; optionales `select` (kommagetrennte Feldnamen) reichert jedes Ergebnis mit den angeforderten Issue-Feldern an |
 | `rebuild_search_index` | Suchindex aufbauen oder aktualisieren; `full: true` löscht und baut ihn vollständig neu |
 | `get_search_index_status` | Aktuellen Füllstand des Suchindex zurückgeben: wie viele Issues bereits indiziert sind im Verhältnis zur Gesamtanzahl, plus Zeitstempel der letzten Synchronisation |
 
@@ -188,7 +189,7 @@ npm install sqlite-vec better-sqlite3
 | `get_current_user` | Eigenes Benutzerprofil abrufen |
 | `list_languages` | Verfügbare Sprachen auflisten |
 | `get_config` | Server-Konfiguration (Basis-URL, Cache-TTL) anzeigen |
-| `get_issue_enums` | Gültige ID/Name-Paare für alle Enum-Felder zurückgeben (Severity, Status, Priority, Resolution, Reproducibility) — vor `create_issue` / `update_issue` verwenden, um korrekte Werte nachzuschlagen |
+| `get_issue_enums` | Gültige ID/Name-Paare für alle Enum-Felder zurückgeben (Severity, Status, Priority, Resolution, Reproducibility) — vor `create_issue` / `update_issue` verwenden, um korrekte Werte nachzuschlagen; auf lokalisierten Installationen kann jeder Eintrag ein `canonical_name`-Feld mit dem englischen Standard-API-Namen enthalten |
 | `get_mantis_version` | MantisBT-Version abrufen und auf Updates prüfen |
 | `get_mcp_version` | Version dieser mantisbt-mcp-server-Instanz zurückgeben |
 

package/README.md

@@ -73,6 +73,7 @@ npm run build
 | `MANTIS_SEARCH_BACKEND` | – | `vectra` | Vector store backend: `vectra` (pure JS) or `sqlite-vec` (requires manual install) |
 | `MANTIS_SEARCH_DIR` | – | `{MANTIS_CACHE_DIR}/search` | Directory for the search index |
 | `MANTIS_SEARCH_MODEL` | – | `Xenova/paraphrase-multilingual-MiniLM-L12-v2` | Embedding model name (downloaded once on first use, ~80 MB) |
+| `MANTIS_SEARCH_THREADS` | – | `1` | Number of ONNX intra-op threads for the embedding model. Default is 1 to prevent CPU saturation on multi-core machines and WSL. Increase only if index rebuild speed matters and the host is dedicated to this workload. |
 
 ### Config file (fallback)
 
@@ -93,7 +94,7 @@ If no environment variables are set, `~/.claude/mantis.json` is read:
 |---|---|
 | `get_issue` | Retrieve an issue by its numeric ID |
 | `list_issues` | Filter issues by project, status, author, and more; optional `select` for field projection and `status` for client-side status filtering |
-| `create_issue` | Create a new issue |
+| `create_issue` | Create a new issue; optional `handler` parameter accepts a username as alternative to `handler_id` (resolved against project members) |
 | `update_issue` | Update an existing issue |
 | `delete_issue` | Delete an issue |
 
@@ -116,7 +117,7 @@ If no environment variables are set, `~/.claude/mantis.json` is read:
 
 | Tool | Description |
 |---|---|
-| `add_relationship` | Create a relationship between two issues |
+| `add_relationship` | Create a relationship between two issues; optional `type_name` parameter accepts a string name (e.g. `"related_to"`, `"duplicate_of"`) as alternative to numeric `type_id` |
 | `remove_relationship` | Remove a relationship from an issue (use the `id` from the relationship object, not the type) |
 
 ### Monitors
@@ -157,7 +158,7 @@ Activate with `MANTIS_SEARCH_ENABLED=true`.
 
 | Tool | Description |
 |---|---|
-| `search_issues` | Natural language search over all indexed issues — returns top-N results with cosine similarity score |
+| `search_issues` | Natural language search over all indexed issues — returns top-N results with cosine similarity score; optional `select` (comma-separated field names) enriches each result with the requested issue fields |
 | `rebuild_search_index` | Build or update the search index; `full: true` clears and rebuilds from scratch |
 | `get_search_index_status` | Return the current fill level of the search index: how many issues are indexed vs. total, and the timestamp of the last sync |
 
@@ -188,7 +189,7 @@ npm install sqlite-vec better-sqlite3
 | `get_current_user` | Retrieve your own user profile |
 | `list_languages` | List available languages |
 | `get_config` | Show server configuration (base URL, cache TTL) |
-| `get_issue_enums` | Return valid ID/name pairs for all issue enum fields (severity, status, priority, resolution, reproducibility) — use before `create_issue` / `update_issue` to look up correct values |
+| `get_issue_enums` | Return valid ID/name pairs for all issue enum fields (severity, status, priority, resolution, reproducibility) — use before `create_issue` / `update_issue` to look up correct values; on localized installations each entry may include a `canonical_name` with the standard English API name |
 | `get_mantis_version` | Get MantisBT version and check for updates |
 | `get_mcp_version` | Return the version of this mantisbt-mcp-server instance |
 

package/dist/config.js

@@ -76,6 +76,7 @@ export async function getConfig() {
     const searchDir = process.env.MANTIS_SEARCH_DIR ?? join(cacheDir, 'search');
     const searchModelName = process.env.MANTIS_SEARCH_MODEL ??
         'Xenova/paraphrase-multilingual-MiniLM-L12-v2';
+    const searchNumThreads = Math.max(1, parseInt(process.env.MANTIS_SEARCH_THREADS ?? '', 10) || 1);
     cachedConfig = {
         baseUrl: baseUrl.replace(/\/$/, ''), // strip trailing slash
         apiKey,
@@ -86,6 +87,7 @@ export async function getConfig() {
             backend: searchBackend,
             dir: searchDir,
             modelName: searchModelName,
+            numThreads: searchNumThreads,
         },
     };
     return cachedConfig;

package/dist/constants.js

@@ -10,12 +10,89 @@ export const RELATIONSHIP_TYPES = {
     HAS_DUPLICATE: 4,
 };
 // ---------------------------------------------------------------------------
+// Relationship type name → ID mapping (string aliases accepted by add_relationship)
+// ---------------------------------------------------------------------------
+export const RELATIONSHIP_NAME_TO_ID = {
+    'duplicate_of': RELATIONSHIP_TYPES.DUPLICATE_OF,
+    'duplicate-of': RELATIONSHIP_TYPES.DUPLICATE_OF,
+    'duplicateof': RELATIONSHIP_TYPES.DUPLICATE_OF,
+    'related_to': RELATIONSHIP_TYPES.RELATED_TO,
+    'related-to': RELATIONSHIP_TYPES.RELATED_TO,
+    'relatedto': RELATIONSHIP_TYPES.RELATED_TO,
+    'parent_of': RELATIONSHIP_TYPES.PARENT_OF,
+    'parent-of': RELATIONSHIP_TYPES.PARENT_OF,
+    'parentof': RELATIONSHIP_TYPES.PARENT_OF,
+    'depends_on': RELATIONSHIP_TYPES.PARENT_OF,
+    'depends-on': RELATIONSHIP_TYPES.PARENT_OF,
+    'dependson': RELATIONSHIP_TYPES.PARENT_OF,
+    'child_of': RELATIONSHIP_TYPES.CHILD_OF,
+    'child-of': RELATIONSHIP_TYPES.CHILD_OF,
+    'childof': RELATIONSHIP_TYPES.CHILD_OF,
+    'blocks': RELATIONSHIP_TYPES.CHILD_OF,
+    'has_duplicate': RELATIONSHIP_TYPES.HAS_DUPLICATE,
+    'has-duplicate': RELATIONSHIP_TYPES.HAS_DUPLICATE,
+    'hasduplicate': RELATIONSHIP_TYPES.HAS_DUPLICATE,
+};
+// ---------------------------------------------------------------------------
 // Status names (internal English names used in API calls)
 // ---------------------------------------------------------------------------
 // MantisBT default status ID for "resolved". Issues with status.id strictly
 // below this value are considered open (new/feedback/acknowledged/confirmed/assigned).
 export const MANTIS_RESOLVED_STATUS_ID = 80;
 // ---------------------------------------------------------------------------
+// Canonical English enum names for standard MantisBT installations.
+// Keyed by the enum group name (without _enum_string suffix).
+// Used by get_issue_enums to add a canonical_name field on localized installs.
+// ---------------------------------------------------------------------------
+export const MANTIS_CANONICAL_ENUM_NAMES = {
+    severity: {
+        10: 'feature',
+        20: 'trivial',
+        30: 'text',
+        40: 'tweak',
+        50: 'minor',
+        60: 'major',
+        70: 'crash',
+        80: 'block',
+    },
+    status: {
+        10: 'new',
+        20: 'feedback',
+        30: 'acknowledged',
+        40: 'confirmed',
+        50: 'assigned',
+        80: 'resolved',
+        90: 'closed',
+    },
+    priority: {
+        10: 'none',
+        20: 'low',
+        30: 'normal',
+        40: 'high',
+        50: 'urgent',
+        60: 'immediate',
+    },
+    resolution: {
+        10: 'open',
+        20: 'fixed',
+        30: 'reopened',
+        40: 'unable to duplicate',
+        50: 'not fixable',
+        60: 'duplicate',
+        70: 'no change required',
+        80: 'suspended',
+        90: 'wont fix',
+    },
+    reproducibility: {
+        10: 'always',
+        30: 'sometimes',
+        50: 'random',
+        70: 'have not tried',
+        90: 'unable to reproduce',
+        100: 'N/A',
+    },
+};
+// ---------------------------------------------------------------------------
 // Issue enum config option names
 // ---------------------------------------------------------------------------
 export const ISSUE_ENUM_OPTIONS = [

package/dist/index.js

@@ -42,7 +42,7 @@ async function createMcpServer() {
         name: 'mantisbt-mcp-server',
         version,
     });
-    registerIssueTools(server, client);
+    registerIssueTools(server, client, cache);
     registerNoteTools(server, client);
     registerFileTools(server, client);
     registerRelationshipTools(server, client);

package/dist/search/embedder.js

@@ -8,14 +8,16 @@
 // ---------------------------------------------------------------------------
 export class Embedder {
     modelName;
+    numThreads;
     pipe = null;
-    constructor(modelName) {
+    constructor(modelName, numThreads = 1) {
         this.modelName = modelName;
+        this.numThreads = numThreads;
     }
     async load() {
         if (this.pipe)
             return this.pipe;
-        process.stderr.write(`[mantisbt-search] Loading embedding model ${this.modelName}...\n`);
+        process.stderr.write(`[mantisbt-search] Loading embedding model ${this.modelName} (threads: ${this.numThreads})...\n`);
         let transformers;
         try {
             // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
@@ -25,7 +27,12 @@ export class Embedder {
             const msg = err instanceof Error ? err.message : String(err);
             throw new Error(`Failed to load @huggingface/transformers: ${msg}`);
         }
-        this.pipe = await transformers.pipeline('feature-extraction', this.modelName);
+        this.pipe = await transformers.pipeline('feature-extraction', this.modelName, {
+            session_options: {
+                intra_op_num_threads: this.numThreads,
+                inter_op_num_threads: 1, // Transformer graphs are sequential — no benefit from inter-op parallelism
+            },
+        });
         return this.pipe;
     }
     async embed(text) {

package/dist/search/index.js

@@ -9,7 +9,7 @@ export async function initializeSearchModule(server, client, config) {
     if (!config.enabled)
         return;
     const store = createVectorStore(config.backend, config.dir);
-    const embedder = new Embedder(config.modelName);
+    const embedder = new Embedder(config.modelName, config.numThreads);
     registerSearchTools(server, client, store, embedder);
     // Pre-initialize lastKnownTotal so get_search_index_status shows a value
     // immediately on startup, even while the background sync is still running.

package/dist/search/tools.js

@@ -27,13 +27,16 @@ export function registerSearchTools(server, client, store, embedder) {
                 .max(50)
                 .default(10)
                 .describe('Number of results to return (default: 10, max: 50)'),
+            select: z.string().optional().describe('Comma-separated list of fields to include for each result (e.g. "id,summary,status,handler,priority"). ' +
+                'When provided, each matching issue is fetched from MantisBT and enriched with the requested fields. ' +
+                'The relevance score is always included. Without this parameter only id and score are returned.'),
         }),
         annotations: {
             readOnlyHint: true,
             destructiveHint: false,
             idempotentHint: true,
         },
-    }, async ({ query, top_n }) => {
+    }, async ({ query, top_n, select }) => {
         try {
             const count = await store.count();
             if (count === 0) {
@@ -49,8 +52,30 @@ export function registerSearchTools(server, client, store, embedder) {
             }
             const queryVector = await embedder.embed(query);
             const results = await store.search(queryVector, top_n);
+            if (!select) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+                };
+            }
+            const fields = select.split(',').map(f => f.trim()).filter(Boolean);
+            const enriched = await Promise.all(results.map(async ({ id, score }) => {
+                try {
+                    const issueResult = await client.get(`issues/${id}`);
+                    const issue = issueResult.issues?.[0] ?? {};
+                    const projected = { id, score };
+                    for (const field of fields) {
+                        if (field !== 'id' && field in issue) {
+                            projected[field] = issue[field];
+                        }
+                    }
+                    return projected;
+                }
+                catch {
+                    return { id, score };
+                }
+            }));
             return {
-                content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(enriched, null, 2) }],
             };
         }
         catch (error) {

package/dist/tools/config.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ISSUE_ENUM_OPTIONS } from '../constants.js';
+import { ISSUE_ENUM_OPTIONS, MANTIS_CANONICAL_ENUM_NAMES } from '../constants.js';
 import { getVersionHint } from '../version-hint.js';
 function errorText(msg) {
     const vh = getVersionHint();
@@ -21,6 +21,10 @@ function parseEnumString(raw) {
     })
         .filter((e) => e !== null);
 }
+function resolveCanonicalName(id, name, canonicalMap) {
+    const canonical = canonicalMap[id];
+    return canonical !== undefined && canonical !== name ? canonical : undefined;
+}
 export function registerConfigTools(server, client, cache) {
     // ---------------------------------------------------------------------------
     // get_config
@@ -130,14 +134,24 @@ to use for API calls — regardless of language.`,
                 const key = keyMap[option];
                 if (!key)
                     continue;
+                const canonicalMap = MANTIS_CANONICAL_ENUM_NAMES[key] ?? {};
                 if (typeof value === 'string') {
-                    enums[key] = parseEnumString(value);
+                    enums[key] = parseEnumString(value).map(({ id, name }) => {
+                        const entry = { id, name };
+                        const canonical_name = resolveCanonicalName(id, name, canonicalMap);
+                        if (canonical_name !== undefined)
+                            entry.canonical_name = canonical_name;
+                        return entry;
+                    });
                 }
                 else if (Array.isArray(value)) {
                     enums[key] = value.map(({ id, name, label }) => {
                         const entry = { id, name };
                         if (label && label !== name)
                             entry.label = label;
+                        const canonical_name = resolveCanonicalName(id, name, canonicalMap);
+                        if (canonical_name !== undefined)
+                            entry.canonical_name = canonical_name;
                         return entry;
                     });
                 }

package/dist/tools/issues.js

@@ -7,7 +7,7 @@ function errorText(msg) {
     const hint = vh?.getUpdateHint();
     return hint ? `Error: ${msg}\n\n${hint}` : `Error: ${msg}`;
 }
-export function registerIssueTools(server, client) {
+export function registerIssueTools(server, client, cache) {
     // ---------------------------------------------------------------------------
     // get_issue
     // ---------------------------------------------------------------------------
@@ -141,13 +141,38 @@ export function registerIssueTools(server, client) {
             priority: z.string().optional().describe('Priority name (e.g. "normal", "high", "urgent", "immediate", "low", "none")'),
             severity: z.string().default('minor').describe('Severity name (e.g. "minor", "major", "crash", "block", "feature", "trivial", "text") — default: "minor"'),
             handler_id: z.coerce.number().int().positive().optional().describe('User ID of the person to assign the issue to'),
+            handler: z.string().optional().describe('Username (login name) of the person to assign the issue to. Alternative to handler_id — the server resolves the name to a user ID from the project members. Use get_project_users to see available users.'),
         }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
             idempotentHint: false,
         },
-    }, async ({ summary, description, project_id, category, priority, severity, handler_id }) => {
+    }, async ({ summary, description, project_id, category, priority, severity, handler_id, handler }) => {
+        // Resolve handler username to handler_id when only a name is given
+        let resolvedHandlerId = handler_id;
+        if (resolvedHandlerId === undefined && handler !== undefined) {
+            const metadata = await cache.loadIfValid();
+            let users = metadata?.byProject[project_id]?.users ?? [];
+            if (users.length === 0) {
+                try {
+                    const usersResult = await client.get(`projects/${project_id}/users`);
+                    users = usersResult.users ?? [];
+                }
+                catch {
+                    users = [];
+                }
+            }
+            const user = users.find(u => u.name === handler || u.real_name === handler);
+            if (!user) {
+                const names = users.map(u => u.name).join(', ');
+                return {
+                    content: [{ type: 'text', text: errorText(`User "${handler}" not found in project ${project_id}. Available users: ${names || 'none (run sync_metadata or check project_id)'}`) }],
+                    isError: true,
+                };
+            }
+            resolvedHandlerId = user.id;
+        }
         try {
             const body = {
                 summary,
@@ -158,11 +183,26 @@ export function registerIssueTools(server, client) {
             if (priority)
                 body.priority = { name: priority };
             body.severity = { name: severity };
-            if (handler_id)
-                body.handler = { id: handler_id };
-            const result = await client.post('issues', body);
+            if (resolvedHandlerId)
+                body.handler = { id: resolvedHandlerId };
+            const raw = await client.post('issues', body);
+            const partial = ('issue' in raw && typeof raw['issue'] === 'object' && raw['issue'] !== null)
+                ? raw['issue']
+                : raw;
+            let issue = partial;
+            if (!('summary' in partial)) {
+                // Older MantisBT returned only { id: N } — fetch the full issue.
+                // Suppress GET errors: the issue was already created.
+                try {
+                    const fetched = await client.get(`issues/${partial.id}`);
+                    issue = fetched.issues?.[0] ?? partial;
+                }
+                catch {
+                    // unable to fetch details — return minimal object
+                }
+            }
             return {
-                content: [{ type: 'text', text: JSON.stringify(result.issue ?? result, null, 2) }],
+                content: [{ type: 'text', text: JSON.stringify(issue, null, 2) }],
             };
         }
         catch (error) {

package/dist/tools/relationships.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { RELATIONSHIP_TYPES } from '../constants.js';
+import { RELATIONSHIP_TYPES, RELATIONSHIP_NAME_TO_ID } from '../constants.js';
 import { getVersionHint } from '../version-hint.js';
 function errorText(msg) {
     const vh = getVersionHint();
@@ -15,31 +15,47 @@ export function registerRelationshipTools(server, client) {
         title: 'Add Issue Relationship',
         description: `Add a relationship between two MantisBT issues.
 
-Relationship type IDs:
-- ${RELATIONSHIP_TYPES.DUPLICATE_OF} = duplicate_of    — this issue is a duplicate of target
-- ${RELATIONSHIP_TYPES.RELATED_TO}   = related_to      — this issue is related to target
-- ${RELATIONSHIP_TYPES.PARENT_OF}    = parent_of       — this issue depends on target (target must be done first)
-- ${RELATIONSHIP_TYPES.CHILD_OF}     = child_of        — this issue blocks target (target can't proceed until this is done)
-- ${RELATIONSHIP_TYPES.HAS_DUPLICATE} = has_duplicate  — this issue has target as a duplicate
+Relationship types — use either type_id (numeric) or type_name (string):
+- ${RELATIONSHIP_TYPES.DUPLICATE_OF} / "duplicate_of"  — this issue is a duplicate of target
+- ${RELATIONSHIP_TYPES.RELATED_TO}   / "related_to"    — this issue is related to target
+- ${RELATIONSHIP_TYPES.PARENT_OF}    / "parent_of"     — this issue depends on target (target must be done first); alias: "depends_on"
+- ${RELATIONSHIP_TYPES.CHILD_OF}     / "child_of"      — this issue blocks target (target can't proceed until this is done); alias: "blocks"
+- ${RELATIONSHIP_TYPES.HAS_DUPLICATE} / "has_duplicate" — this issue has target as a duplicate
 
 Directionality note: "A child_of B" means A blocks B. "A parent_of B" means A depends on B.
 
-Important: The API only accepts numeric type IDs, not string names.`,
+Dash variants (e.g. "related-to") are also accepted for type_name.`,
         inputSchema: z.object({
             issue_id: z.coerce.number().int().positive().describe('The source issue ID (the one the relationship is added to)'),
             target_id: z.coerce.number().int().positive().describe('The target issue ID'),
-            type_id: z.coerce.number().int().min(0).max(4).describe(`Relationship type ID: 0=duplicate_of, 1=related_to, 2=parent_of (depends on), 3=child_of (blocks), 4=has_duplicate`),
+            type_id: z.coerce.number().int().min(0).max(4).optional().describe('Relationship type ID: 0=duplicate_of, 1=related_to, 2=parent_of (depends on), 3=child_of (blocks), 4=has_duplicate. Use either type_id or type_name.'),
+            type_name: z.string().optional().describe('Relationship type name as alternative to type_id. Accepted: "duplicate_of", "related_to", "parent_of" (or "depends_on"), "child_of" (or "blocks"), "has_duplicate". Dash variants (e.g. "related-to") also work.'),
         }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
             idempotentHint: false,
         },
-    }, async ({ issue_id, target_id, type_id }) => {
+    }, async ({ issue_id, target_id, type_id, type_name }) => {
+        // Resolve type_id from type_name when type_id is not provided
+        let resolvedTypeId = type_id;
+        if (resolvedTypeId === undefined) {
+            if (type_name === undefined) {
+                return { content: [{ type: 'text', text: errorText('Either type_id or type_name must be provided') }], isError: true };
+            }
+            const normalized = type_name.toLowerCase().replace(/-/g, '_');
+            resolvedTypeId = RELATIONSHIP_NAME_TO_ID[normalized];
+            if (resolvedTypeId === undefined) {
+                return {
+                    content: [{ type: 'text', text: errorText(`Unknown relationship type name: "${type_name}". Valid values: duplicate_of, related_to, parent_of, child_of, has_duplicate`) }],
+                    isError: true,
+                };
+            }
+        }
         try {
             const body = {
                 issue: { id: target_id },
-                type: { id: type_id },
+                type: { id: resolvedTypeId },
             };
             const result = await client.post(`issues/${issue_id}/relationships`, body);
             return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpesch/mantisbt-mcp-server",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "MCP server for MantisBT REST API – read and manage bug tracker issues",
   "author": "Dominik Pesch",
   "license": "MIT",

package/tests/fixtures/recorded/get_current_user.json

@@ -0,0 +1,108 @@
+{
+  "id": 51,
+  "name": "domAgent",
+  "real_name": "Dominik Pesch (via Agent)",
+  "email": "d.pesch+agent@11com7.de",
+  "language": "german",
+  "timezone": "Europe/Berlin",
+  "access_level": {
+    "id": 70,
+    "name": "manager",
+    "label": "Manager"
+  },
+  "created_at": "2026-02-28T09:08:30+01:00",
+  "projects": [
+    {
+      "id": 30,
+      "name": "((Haus)) (Bolliggasse 1a)"
+    },
+    {
+      "id": 54,
+      "name": "11com7 Claude MetaRepo"
+    },
+    {
+      "id": 2,
+      "name": "11com7 ContentGo-Lib"
+    },
+    {
+      "id": 48,
+      "name": "11com7 DevServer"
+    },
+    {
+      "id": 25,
+      "name": "11com7 GmbH"
+    },
+    {
+      "id": 39,
+      "name": "11com7 Hosting (Keyweb, Ansible)"
+    },
+    {
+      "id": 44,
+      "name": "11com7-Ausbildung-FIAE"
+    },
+    {
+      "id": 52,
+      "name": "11com7-DVMS (Datenschutzverletzungsmelder)"
+    },
+    {
+      "id": 5,
+      "name": "11com7-Homepage"
+    },
+    {
+      "id": 27,
+      "name": "b11com7"
+    },
+    {
+      "id": 3,
+      "name": "BIBB NAA309"
+    },
+    {
+      "id": 11,
+      "name": "BIBB wbmonitor"
+    },
+    {
+      "id": 38,
+      "name": "DSGV Budgetanalyse 3"
+    },
+    {
+      "id": 28,
+      "name": "DSGV Finanzchecker (App)"
+    },
+    {
+      "id": 45,
+      "name": "DSGV Finanzchecker (Landingpage)"
+    },
+    {
+      "id": 40,
+      "name": "DSGV Login"
+    },
+    {
+      "id": 26,
+      "name": "DSGV Referenzbudgets"
+    },
+    {
+      "id": 8,
+      "name": "DSGV Vortragsservice"
+    },
+    {
+      "id": 14,
+      "name": "DSGV Web-Budgetplaner"
+    },
+    {
+      "id": 42,
+      "name": "Lingua-World"
+    },
+    {
+      "id": 49,
+      "name": "SIK M&E-App"
+    },
+    {
+      "id": 21,
+      "name": "Uni Bonn (Hausprint V2)"
+    },
+    {
+      "id": 53,
+      "name": "ZEEEM GSM-Landingpage"
+    }
+  ]
+}