@daghis/teamcity-mcp 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.11.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.10.0...teamcity-mcp-v2.11.0) (2026-05-03)
+
+
+### Features
+
+* **artifacts:** add list_build_artifacts tool for subdirectory browsing ([#489](https://github.com/Daghis/teamcity-mcp/issues/489)) ([eacad61](https://github.com/Daghis/teamcity-mcp/commit/eacad6115cbb33a6e660bd096e59869c4fcf4ea8))
+
 ## [2.10.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.9.0...teamcity-mcp-v2.10.0) (2026-04-26)
 
 

package/dist/index.js

@@ -1205,7 +1205,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.10.0",
+  version: "2.11.0",
   description: "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   mcpName: "io.github.Daghis/teamcity",
   main: "dist/index.js",
@@ -1294,7 +1294,7 @@ var package_default = {
     "eslint-plugin-prettier": "^5.0.1",
     globals: "^17.4.0",
     jest: "^30.1.3",
-    "jest-junit": "^16.0.0",
+    "jest-junit": "^17.0.0",
     "js-yaml": "^4.1.1",
     prettier: "^3.1.0",
     "ts-jest": "^29.4.9",
@@ -1550,13 +1550,20 @@ var ArtifactManager = class _ArtifactManager {
       const buildLocator = toBuildLocator(buildId);
       const response = await this.client.modules.builds.getFilesListOfBuild(
         buildLocator,
-        void 0,
+        options.path,
         void 0,
         "file(name,fullName,size,modificationTime,href,children(file(name,fullName,size,modificationTime,href)))"
       );
       const baseUrl = this.getBaseUrl();
       const artifactPayload = this.ensureArtifactListingResponse(response.data, buildId);
-      let artifacts = this.parseArtifacts(artifactPayload, buildId, options.includeNested, baseUrl);
+      let artifacts = this.parseArtifacts(
+        artifactPayload,
+        buildId,
+        options.includeNested,
+        baseUrl,
+        [],
+        options.includeDirectories
+      );
       artifacts = this.applyFilters(artifacts, options);
       if (options.limit ?? options.offset) {
         artifacts = this.paginate(
@@ -1788,7 +1795,7 @@ var ArtifactManager = class _ArtifactManager {
     }
     return payload;
   }
-  parseArtifacts(data, buildId, includeNested, baseUrl, parentSegments = []) {
+  parseArtifacts(data, buildId, includeNested, baseUrl, parentSegments = [], includeDirectories) {
     const artifacts = [];
     const files = data.file ?? [];
     for (const file of files) {
@@ -1796,13 +1803,24 @@ var ArtifactManager = class _ArtifactManager {
       const resolvedPath = pathSegments.join("/");
       const isDirectory = Boolean(file.children);
       if (isDirectory) {
+        if (includeDirectories && resolvedPath) {
+          artifacts.push({
+            name: file.name ?? pathSegments[pathSegments.length - 1] ?? "",
+            path: resolvedPath,
+            size: file.size ?? 0,
+            modificationTime: file.modificationTime ?? "",
+            downloadUrl: `${baseUrl}/app/rest/builds/id:${buildId}/artifacts/content/${this.encodeArtifactPath(pathSegments)}`,
+            isDirectory: true
+          });
+        }
         if (includeNested && file.children) {
           const nested = this.parseArtifacts(
             file.children,
             buildId,
             includeNested,
             baseUrl,
-            pathSegments
+            pathSegments,
+            includeDirectories
           );
           artifacts.push(...nested);
         }
@@ -41424,6 +41442,72 @@ var DEV_TOOLS = [
       );
     }
   },
+  {
+    name: "list_build_artifacts",
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    description: "List artifact files and directories for a build, optionally browsing into subdirectories. Returns an array of artifact entries with name, path, size, and isDirectory flag.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ...buildIdentifierInputProperties,
+        path: {
+          type: "string",
+          description: 'Sub-path to list (e.g. "okd" or "okd/subdir"). Omit to list top-level artifacts.'
+        },
+        includeNested: {
+          type: "boolean",
+          description: "Recursively include all files within subdirectories (default: false)"
+        },
+        nameFilter: {
+          type: "string",
+          description: 'Glob pattern to filter artifacts by name (e.g. "*.yaml")'
+        },
+        pathFilter: {
+          type: "string",
+          description: "Glob pattern to filter artifacts by full path"
+        },
+        extension: {
+          type: "string",
+          description: 'Filter by file extension (e.g. "yaml", ".yaml")'
+        }
+      }
+    },
+    handler: async (args) => {
+      const schema = buildIdentifierSchema.and(
+        import_zod4.z.object({
+          path: import_zod4.z.string().trim().min(1).optional(),
+          includeNested: import_zod4.z.boolean().optional(),
+          nameFilter: import_zod4.z.string().trim().min(1).optional(),
+          pathFilter: import_zod4.z.string().trim().min(1).optional(),
+          extension: import_zod4.z.string().trim().min(1).optional()
+        })
+      );
+      return runTool(
+        "list_build_artifacts",
+        schema,
+        async (typed) => {
+          const adapter = createAdapterFromTeamCityAPI(TeamCityAPI.getInstance());
+          const { locator: buildLocator } = resolveBuildLocator(typed);
+          const manager = new ArtifactManager(adapter);
+          const artifacts = await manager.listArtifacts(buildLocator, {
+            path: typed.path,
+            includeNested: typed.includeNested,
+            includeDirectories: true,
+            nameFilter: typed.nameFilter,
+            pathFilter: typed.pathFilter,
+            extension: typed.extension
+          });
+          return json({ artifacts });
+        },
+        args
+      );
+    }
+  },
   {
     name: "download_build_artifact",
     annotations: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daghis/teamcity-mcp",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "description": "Model Control Protocol server for TeamCity CI/CD integration with AI coding assistants",
   "mcpName": "io.github.Daghis/teamcity",
   "main": "dist/index.js",
@@ -89,7 +89,7 @@
     "eslint-plugin-prettier": "^5.0.1",
     "globals": "^17.4.0",
     "jest": "^30.1.3",
-    "jest-junit": "^16.0.0",
+    "jest-junit": "^17.0.0",
     "js-yaml": "^4.1.1",
     "prettier": "^3.1.0",
     "ts-jest": "^29.4.9",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/Daghis/teamcity-mcp",
-  "version": "2.10.0",
+  "version": "2.11.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.10.0",
+      "version": "2.11.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {