mcp-ado-browser 1.2.1

package/dist/src/tools/errors.js

@@ -0,0 +1,7 @@
+/** Map any thrown value into a structured AdoError for the MCP boundary. */
+import { AdoError, rehydrateSentinel } from "../errors.js";
+export function toAdoError(e) {
+    if (e instanceof AdoError)
+        return e;
+    return rehydrateSentinel(e);
+}

package/dist/src/transport/mock-transport.js

@@ -0,0 +1,73 @@
+/**
+ * MockTransport: executes canonical ADO URLs against a local MockAdoServer.
+ *
+ * It records the *canonical* (real-host) URL in calledUrls — so cache and live
+ * gates assert on what the client intended to fetch — while physically routing
+ * the request to the mock base. The real host is forwarded in `x-ado-real-host`
+ * so the mock can key fixtures across the 5 ADO hosts on a single port.
+ */
+import { AuthRequiredError, HttpError, NotFoundError } from "../errors.js";
+import { mandatoryHeaders } from "./types.js";
+export class MockTransport {
+    mockBase;
+    kind = "mock";
+    calledUrls = [];
+    fetchCount = 0;
+    lastHeaders = {};
+    constructor(mockBase) {
+        this.mockBase = mockBase;
+    }
+    resetCounters() {
+        this.calledUrls.length = 0;
+        this.fetchCount = 0;
+    }
+    rewrite(url) {
+        const u = new URL(url);
+        const realHost = u.host;
+        const exec = `${this.mockBase}${u.pathname}${u.search}`;
+        return { exec, realHost };
+    }
+    async raw(url, init) {
+        this.calledUrls.push(url);
+        this.fetchCount++;
+        const { exec, realHost } = this.rewrite(url);
+        const res = await fetch(exec, {
+            method: init?.method ?? "GET",
+            headers: mandatoryHeaders({ ...(init?.headers ?? {}), "x-ado-real-host": realHost }),
+            body: init?.body,
+        });
+        if (res.status === 401)
+            throw new AuthRequiredError(url);
+        if (res.status === 404)
+            throw new NotFoundError("resource", url, url);
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new HttpError(res.status, url, body);
+        }
+        return res;
+    }
+    async fetchJson(url, init) {
+        const res = await this.raw(url, init);
+        const data = (await res.json());
+        this.lastHeaders = headerObj(res.headers);
+        return { data, headers: this.lastHeaders };
+    }
+    async fetchBuffer(url, init) {
+        const res = await this.raw(url, init);
+        const ab = await res.arrayBuffer();
+        const data = Buffer.from(ab);
+        const cl = res.headers.get("content-length");
+        this.lastHeaders = headerObj(res.headers);
+        return {
+            data,
+            contentLength: cl != null ? Number(cl) : null,
+            contentType: res.headers.get("content-type"),
+            headers: this.lastHeaders,
+        };
+    }
+}
+function headerObj(h) {
+    const o = {};
+    h.forEach((v, k) => (o[k.toLowerCase()] = v));
+    return o;
+}

package/dist/src/transport/types.js

@@ -0,0 +1,8 @@
+/** The mandatory headers every ADO request must carry (mission §1). */
+export function mandatoryHeaders(extra) {
+    return {
+        Accept: "application/json",
+        "X-TFS-FedAuthRedirect": "Suppress",
+        ...(extra ?? {}),
+    };
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "mcp-ado-browser",
+  "version": "1.2.1",
+  "description": "Read-only Azure DevOps for MCP clients using only your existing browser session — no PAT, no Azure CLI. Browse work items, pull requests, comments, attachments and Artifacts feeds across every project, repo and feed you can access.",
+  "type": "module",
+  "bin": {
+    "mcp-ado-browser": "dist/src/index.js"
+  },
+  "main": "dist/src/index.js",
+  "engines": {
+    "node": ">=22.5"
+  },
+  "license": "MIT",
+  "author": "VMargan (https://github.com/VMargan)",
+  "homepage": "https://github.com/VMargan/mcp-ado-browser#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VMargan/mcp-ado-browser.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VMargan/mcp-ado-browser/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "azure-devops",
+    "ado",
+    "playwright",
+    "browser-session",
+    "no-pat",
+    "work-items",
+    "pull-requests",
+    "artifacts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist/src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/src/index.js",
+    "verify": "tsc -p tsconfig.json && node dist/test/harness/verify.js",
+    "verify:live": "tsc -p tsconfig.json && ADO_LIVE=1 node dist/test/harness/verify.js",
+    "authenticate": "tsc -p tsconfig.json && node dist/src/index.js authenticate",
+    "demo:live": "tsc -p tsconfig.json && node scripts/demo-live.mjs",
+    "scan:secrets": "node scripts/scan-secrets.mjs",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "playwright-core": "^1.49.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.1",
+    "@types/node": "^22.10.0",
+    "semantic-release": "^25.0.5",
+    "typescript": "^5.7.0"
+  }
+}