@daghis/teamcity-mcp 2.10.0 → 2.12.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [2.12.0](https://github.com/Daghis/teamcity-mcp/compare/teamcity-mcp-v2.11.0...teamcity-mcp-v2.12.0) (2026-05-03)
+
+
+### Features
+
+* **http:** forward TEAMCITY_HEADER_* env vars on every request ([#492](https://github.com/Daghis/teamcity-mcp/issues/492)) ([c406511](https://github.com/Daghis/teamcity-mcp/commit/c4065111e2e8c6e807ec9a4383cbbe8d280ca00e))
+
+## [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/README.md

@@ -156,6 +156,14 @@ MCP_MODE=dev
 # TEAMCITY_KEEP_ALIVE=true
 # TEAMCITY_COMPRESSION=true
 
+# Extra headers attached to every TeamCity request — useful when TeamCity
+# sits behind a reverse proxy that gates access on custom headers (e.g.
+# Cloudflare Zero Trust service tokens). One env var per header; the part
+# after `TEAMCITY_HEADER_` is used verbatim as the HTTP header name.
+# Example (note the literal hyphens — most shells need quoting):
+# TEAMCITY_HEADER_CF-Access-Client-Id=<id>
+# TEAMCITY_HEADER_CF-Access-Client-Secret=<secret>
+
 # Retry
 # TEAMCITY_RETRY_ENABLED=true
 # TEAMCITY_MAX_RETRIES=3

package/dist/index.js

@@ -691,6 +691,17 @@ function setServerInstance(server) {
 function getServerInstance() {
   return serverInstance;
 }
+var HEADER_ENV_PREFIX = "TEAMCITY_HEADER_";
+function getTeamCityExtraHeaders() {
+  const headers = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (!key.startsWith(HEADER_ENV_PREFIX) || value === void 0) continue;
+    const headerName = key.slice(HEADER_ENV_PREFIX.length);
+    if (headerName === "") continue;
+    headers[headerName] = value;
+  }
+  return Object.keys(headers).length > 0 ? headers : void 0;
+}
 function getTeamCityUrl() {
   const config2 = getConfig();
   if (!config2.teamcity?.url || config2.teamcity.url.length === 0) {
@@ -1205,7 +1216,7 @@ function debug2(message, meta) {
 // package.json
 var package_default = {
   name: "@daghis/teamcity-mcp",
-  version: "2.10.0",
+  version: "2.12.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 +1305,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 +1561,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 +1806,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 +1814,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);
         }
@@ -38441,6 +38470,7 @@ var TeamCityAPI = class _TeamCityAPI {
       baseURL: basePath,
       timeout,
       headers: {
+        ...config2.extraHeaders ?? {},
         Authorization: `Bearer ${config2.token}`,
         Accept: "application/json",
         "Content-Type": "application/json"
@@ -38469,6 +38499,7 @@ var TeamCityAPI = class _TeamCityAPI {
       baseOptions: {
         timeout,
         headers: {
+          ...config2.extraHeaders ?? {},
           Authorization: `Bearer ${config2.token}`,
           Accept: "application/json"
         }
@@ -38551,7 +38582,8 @@ var TeamCityAPI = class _TeamCityAPI {
     if (this.instance == null) {
       const envConfig = this.normalizeConfig({
         baseUrl: getTeamCityUrl(),
-        token: getTeamCityToken()
+        token: getTeamCityToken(),
+        extraHeaders: getTeamCityExtraHeaders()
       });
       this.instance = new _TeamCityAPI(envConfig);
       this.instanceConfig = envConfig;
@@ -38782,15 +38814,34 @@ var TeamCityAPI = class _TeamCityAPI {
     return {
       baseUrl: config2.baseUrl.replace(/\/$/, ""),
       token: config2.token,
-      timeout: config2.timeout
+      timeout: config2.timeout,
+      extraHeaders: normalizeExtraHeaders(config2.extraHeaders)
     };
   }
   static configsEqual(a, b) {
     if (a == null || b == null) {
       return false;
     }
-    return a.baseUrl === b.baseUrl && a.token === b.token && a.timeout === b.timeout;
+    return a.baseUrl === b.baseUrl && a.token === b.token && a.timeout === b.timeout && extraHeadersEqual(a.extraHeaders, b.extraHeaders);
+  }
+};
+var normalizeExtraHeaders = (headers) => {
+  if (headers == null) {
+    return void 0;
   }
+  const entries = Object.entries(headers);
+  if (entries.length === 0) {
+    return void 0;
+  }
+  return Object.fromEntries(entries.sort(([a], [b]) => a.localeCompare(b)));
+};
+var extraHeadersEqual = (a, b) => {
+  if (a === b) return true;
+  if (a == null || b == null) return a == null && b == null;
+  const keysA = Object.keys(a);
+  const keysB = Object.keys(b);
+  if (keysA.length !== keysB.length) return false;
+  return keysA.every((key) => a[key] === b[key]);
 };
 
 // src/tools.ts
@@ -41424,6 +41475,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.12.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.12.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@daghis/teamcity-mcp",
-      "version": "2.10.0",
+      "version": "2.12.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {