azdo-onprem-mcp 1.0.0

package/.env.example

@@ -0,0 +1,11 @@
+# Copy to .env and fill in (do not commit .env).
+# MCP clients often set these in mcp.json instead of a file.
+
+AZURE_BASE_URL=https://devops.example.com/Collection/MyProject
+AZURE_PAT=
+
+# Optional
+# AZURE_COLLECTION_URL=https://devops.example.com/Collection
+# AZURE_HTTP_TIMEOUT_MS=120000
+# AZURE_DEVOPS_API_VERSION=7.1
+# MCP_DEBUG=0

package/README.md

@@ -0,0 +1,106 @@
+# azdo-onprem-mcp
+
+Minimal [Model Context Protocol](https://modelcontextprotocol.io) server for **self-hosted Azure DevOps Server** (on-premises). It uses the REST APIs with a PAT and **Basic** auth (`curl -u ":$PAT"`), same as Azure DevOps Services patterns but with your own base URL.
+
+**Not** for `dev.azure.com` only—any DevOps Server reachable over HTTPS works if the APIs respond.
+
+## Requirements
+
+- **Node.js** 18+
+- A **Personal Access Token** with at least **Work Items (Read)** (and any other scopes you rely on)
+- **VPN/network** access to your server if required
+
+## Install
+
+```bash
+npm install -g azdo-onprem-mcp
+```
+
+Or run without a global install:
+
+```bash
+npx azdo-onprem-mcp
+```
+
+The package exposes the CLI binary **`azdo-onprem-mcp`** (see `package.json` → `bin`).
+
+## Environment variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `AZURE_BASE_URL` | Yes | **Team project** root URL, same as in the browser for that project, e.g. `https://devops.example.com/Collection/MyProject` (no trailing slash required). |
+| `AZURE_PAT` | Yes | Personal Access Token. Sent as Basic auth with an empty username (`Authorization: Basic base64(":PAT")`). |
+| `AZURE_COLLECTION_URL` | No | Overrides collection root for **`listProjects`** only. If unset, the collection URL is derived by dropping the last path segment of `AZURE_BASE_URL` (e.g. `.../Collection/Project` → `.../Collection`). |
+| `AZURE_HTTP_TIMEOUT_MS` | No | HTTP timeout in ms (default `120000`). |
+| `AZURE_DEVOPS_API_VERSION` | No | REST `api-version` query parameter (default `7.1`). Try `7.0` or `6.0` if your server is older. |
+| `MCP_DEBUG` | No | Set to `1` to log request URLs and timing on stderr (no secrets). |
+
+Do **not** commit secrets. Prefer Cursor/IDE env injection or your OS secret store.
+
+## Cursor (or any MCP client)
+
+Example `mcp.json` entry:
+
+```json
+{
+  "mcpServers": {
+    "azdo-onprem": {
+      "command": "node",
+      "args": ["/absolute/path/to/azure-org-mcp/dist/server.js"],
+      "env": {
+        "AZURE_BASE_URL": "https://devops.example.com/Collection/MyProject",
+        "AZURE_PAT": "<your-pat>"
+      }
+    }
+  }
+}
+```
+
+After installing from npm globally, you can point `command` at the binary if it is on your `PATH`, or keep using `node` with the path to `dist/server.js` from a cloned repo (run `npm run build` first).
+
+Reload MCP / restart the editor after changing env.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `getWorkItem` | `GET` …`/_apis/wit/workitems/{id}?` `$expand=all` — returns the **full** REST body as **MCP `structuredContent`** and as JSON text. Empty field values are often omitted by Azure DevOps; unset fields are not listed. If the chat UI shows a short snippet, use the structured payload (or your client’s tool-result JSON view). |
+| `searchWorkItems` | WIQL search on `System.Title` (contains), then batch-fetch details — returns `{ id, title, state }[]`. |
+| `listProjects` | `GET` …`/_apis/projects` at the **collection** URL (see `AZURE_COLLECTION_URL` / derivation above). |
+
+## Verify with curl (optional)
+
+Mac/Linux: use **single quotes** around the URL so `$expand` is not interpreted by the shell.
+
+```bash
+export AZURE_PAT='your-pat'
+curl -sS -u ":$AZURE_PAT" \
+  'https://your-host/Collection/MyProject/_apis/wit/workitems/12345?$expand=all&api-version=7.1'
+```
+
+## Development
+
+From a clone of this repository:
+
+```bash
+npm install
+npm run build
+npm start
+```
+
+Source lives in `src/` (TypeScript); `npm run build` emits to `dist/`. With `AZURE_BASE_URL` and `AZURE_PAT` set, `npm start` runs the MCP server on stdio (stop with Ctrl+C). Point your MCP client at this command or use `npx azdo-onprem-mcp` after publishing.
+
+## Publish to npm
+
+From the repo root (with `npm login` if needed):
+
+```bash
+npm run build
+npm publish
+```
+
+`prepack` runs `npm run build` automatically, so `dist/` is always fresh in the tarball. For a **scoped** package name (e.g. `@your-scope/azdo-onprem-mcp`), use `npm publish --access public` the first time.
+
+## License
+
+MIT (see `package.json` → `"license"`).

package/dist/client.d.ts

@@ -0,0 +1,16 @@
+import { type AxiosInstance } from "axios";
+/**
+ * Team projects API is rooted at the collection, not the project.
+ * Set AZURE_COLLECTION_URL to override (e.g. https://host/CollectionName).
+ * Otherwise the last path segment of AZURE_BASE_URL is dropped when it looks
+ * like .../Collection/Project.
+ */
+export declare function resolveCollectionBaseUrl(): string;
+/** REST `api-version` query param for all DevOps calls (default 7.1). */
+export declare function devOpsApiVersion(): string;
+/**
+ * Extract a readable message from an Axios error response.
+ */
+export declare function formatAxiosError(err: unknown): string;
+export declare function createAzureDevOpsClient(): AxiosInstance;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAc,EAAmB,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAsBnE;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAkBjD;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC;AA+CD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAyCrD;AAWD,wBAAgB,uBAAuB,IAAI,aAAa,CA6DvD"}

package/dist/client.js

@@ -0,0 +1,177 @@
+import axios from "axios";
+function requireEnv(name) {
+    const v = process.env[name];
+    if (!v || String(v).trim() === "") {
+        throw new Error(`Missing required environment variable: ${name}`);
+    }
+    return String(v).trim();
+}
+/** PAT copy/paste often wraps quotes; trim and strip matching quotes only. */
+function normalizePat(pat) {
+    let p = String(pat).trim();
+    if ((p.startsWith('"') && p.endsWith('"')) ||
+        (p.startsWith("'") && p.endsWith("'"))) {
+        p = p.slice(1, -1).trim();
+    }
+    return p;
+}
+/**
+ * Team projects API is rooted at the collection, not the project.
+ * Set AZURE_COLLECTION_URL to override (e.g. https://host/CollectionName).
+ * Otherwise the last path segment of AZURE_BASE_URL is dropped when it looks
+ * like .../Collection/Project.
+ */
+export function resolveCollectionBaseUrl() {
+    const explicit = process.env.AZURE_COLLECTION_URL?.trim();
+    if (explicit) {
+        return explicit.replace(/\/+$/, "");
+    }
+    const projectBase = requireEnv("AZURE_BASE_URL").replace(/\/+$/, "");
+    let u;
+    try {
+        u = new URL(projectBase);
+    }
+    catch {
+        return projectBase;
+    }
+    const parts = u.pathname.replace(/\/+$/, "").split("/").filter(Boolean);
+    if (parts.length >= 2) {
+        parts.pop();
+        u.pathname = `/${parts.join("/")}`;
+    }
+    return u.toString().replace(/\/+$/, "");
+}
+/** REST `api-version` query param for all DevOps calls (default 7.1). */
+export function devOpsApiVersion() {
+    const v = process.env.AZURE_DEVOPS_API_VERSION?.trim();
+    return v || "7.1";
+}
+/**
+ * Build a Basic auth header for Azure DevOps PAT (empty username).
+ */
+function patAuthorizationHeader(pat) {
+    const token = Buffer.from(`:${pat}`, "utf8").toString("base64");
+    return `Basic ${token}`;
+}
+function responseDetail(data) {
+    if (data == null) {
+        return "";
+    }
+    if (typeof data === "string") {
+        return data.trim();
+    }
+    if (typeof data === "object" && data !== null) {
+        const o = data;
+        if (typeof o.message === "string") {
+            return o.message;
+        }
+        if (typeof o.errorMessage === "string") {
+            return o.errorMessage;
+        }
+        try {
+            const s = JSON.stringify(data);
+            return s === "{}" ? "" : s;
+        }
+        catch {
+            return "";
+        }
+    }
+    return "";
+}
+function errCodeSuffix(err) {
+    if (err &&
+        typeof err === "object" &&
+        "code" in err &&
+        typeof err.code === "string") {
+        return ` [${err.code}]`;
+    }
+    return "";
+}
+/**
+ * Extract a readable message from an Axios error response.
+ */
+export function formatAxiosError(err) {
+    if (!axios.isAxiosError(err)) {
+        const msg = err instanceof Error ? err.message || String(err) : String(err);
+        const code = errCodeSuffix(err);
+        if ((err && typeof err === "object" && err.code === "ECONNABORTED") ||
+            /timeout/i.test(msg)) {
+            return `Request timed out${code}. Increase AZURE_HTTP_TIMEOUT_MS (default 120000) or check VPN/network.`;
+        }
+        return `${msg}${code}`;
+    }
+    if (!err.response) {
+        const code = err.code ? ` [${err.code}]` : "";
+        if (err.code === "ECONNABORTED" || /timeout/i.test(String(err.message))) {
+            return `Request timed out${code}. Increase AZURE_HTTP_TIMEOUT_MS (default 120000) or check VPN/network.`;
+        }
+        return `${err.message || String(err)}${code}`;
+    }
+    const { status, statusText, data } = err.response;
+    const base = `${status} ${statusText || ""}`.trim();
+    const wwwAuth = err.response.headers?.["www-authenticate"];
+    const detail = responseDetail(data);
+    if (status === 401) {
+        const hint = "PAT rejected or anonymous. Fix: use a valid PAT with Work Items (read), set AZURE_BASE_URL to the team project root (same as in the browser), ensure AZURE_PAT is exported in this shell / Cursor MCP env (no extra quotes). Test: curl -sS -u \":$AZURE_PAT\" \"$AZURE_BASE_URL/_apis/wit/workitems?ids=1&api-version=7.1\"";
+        const authHint = wwwAuth ? ` www-authenticate: ${wwwAuth}.` : "";
+        return detail
+            ? `${base}: ${detail}.${authHint} ${hint}`
+            : `${base}.${authHint} ${hint}`;
+    }
+    if (detail) {
+        return `${base}: ${detail}`;
+    }
+    return base;
+}
+function httpTimeoutMs() {
+    const raw = process.env.AZURE_HTTP_TIMEOUT_MS;
+    if (raw == null || String(raw).trim() === "") {
+        return 120_000;
+    }
+    const n = Number.parseInt(String(raw), 10);
+    return Number.isFinite(n) && n > 0 ? n : 120_000;
+}
+export function createAzureDevOpsClient() {
+    const baseURL = requireEnv("AZURE_BASE_URL").replace(/\/+$/, "");
+    const pat = normalizePat(requireEnv("AZURE_PAT"));
+    const timeout = httpTimeoutMs();
+    const client = axios.create({
+        baseURL,
+        timeout,
+        headers: {
+            Authorization: patAuthorizationHeader(pat),
+            Accept: "application/json",
+            "Content-Type": "application/json",
+        },
+        validateStatus: (s) => s >= 200 && s < 300,
+        responseType: "json",
+    });
+    if (process.env.MCP_DEBUG === "1") {
+        client.interceptors.request.use((config) => {
+            const uri = client.getUri(config);
+            const h = config.headers;
+            const auth = (typeof h.get === "function" ? h.get("Authorization") : null) ||
+                h.Authorization ||
+                h.common?.Authorization;
+            console.error(`[MCP_DEBUG] ${config.method?.toUpperCase()} ${uri}`);
+            console.error(`[MCP_DEBUG] Authorization header: ${auth ? "present" : "MISSING (would get TF400813 / anonymous)"}`);
+            console.error(`[MCP_DEBUG] timeout ${timeout}ms (set AZURE_HTTP_TIMEOUT_MS to change)`);
+            config.mcpRequestStart = Date.now();
+            return config;
+        });
+        client.interceptors.response.use((res) => {
+            const started = res.config?.mcpRequestStart;
+            const ms = started != null ? Date.now() - started : null;
+            console.error(`[MCP_DEBUG] ${res.status} in ${ms != null ? `${ms}ms` : "?ms"}`);
+            return res;
+        }, (error) => {
+            const started = error.config?.mcpRequestStart;
+            const ms = started != null ? Date.now() - started : null;
+            console.error(`[MCP_DEBUG] failed after ${ms != null ? `${ms}ms` : "?ms"}: ${error.message}`);
+            return Promise.reject(error);
+        });
+    }
+    client.interceptors.response.use((res) => res, (err) => Promise.reject(new Error(formatAxiosError(err))));
+    return client;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/projects.d.ts

@@ -0,0 +1,13 @@
+import type { AxiosInstance } from "axios";
+export interface TeamProjectSummary {
+    id: string;
+    name: string;
+    state: string;
+    visibility: string;
+}
+/**
+ * List team projects in the collection (GET Core /projects).
+ * Uses collection-scoped base URL; see resolveCollectionBaseUrl in client.ts.
+ */
+export declare function listProjects(client: AxiosInstance): Promise<TeamProjectSummary[]>;
+//# sourceMappingURL=projects.d.ts.map

package/dist/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAY/B"}

package/dist/projects.js

@@ -0,0 +1,19 @@
+import { devOpsApiVersion, resolveCollectionBaseUrl } from "./client.js";
+/**
+ * List team projects in the collection (GET Core /projects).
+ * Uses collection-scoped base URL; see resolveCollectionBaseUrl in client.ts.
+ */
+export async function listProjects(client) {
+    const collectionBase = resolveCollectionBaseUrl();
+    const url = `${collectionBase}/_apis/projects`;
+    const { data } = await client.get(url, {
+        params: { "api-version": devOpsApiVersion() },
+    });
+    return (data.value ?? []).map((p) => ({
+        id: String(p.id ?? ""),
+        name: String(p.name ?? ""),
+        state: String(p.state ?? ""),
+        visibility: String(p.visibility ?? ""),
+    }));
+}
+//# sourceMappingURL=projects.js.map

package/dist/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../src/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAoBzE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAqB;IAErB,MAAM,cAAc,GAAG,wBAAwB,EAAE,CAAC;IAClD,MAAM,GAAG,GAAG,GAAG,cAAc,iBAAiB,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAsB,GAAG,EAAE;QAC1D,MAAM,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,EAAE;KAC9C,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC;KACvC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createAzureDevOpsClient } from "./client.js";
+import { registerTools } from "./tools.js";
+async function main() {
+    const client = createAzureDevOpsClient();
+    const server = new McpServer({
+        name: "azure-devops-server",
+        version: "1.0.0",
+    });
+    registerTools(server, client);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    const msg = err && typeof err === "object" && "message" in err
+        ? String(err.message)
+        : String(err);
+    console.error(msg);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,GAAG,GACP,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,SAAS,IAAI,GAAG;QAChD,CAAC,CAAC,MAAM,CAAE,GAA4B,CAAC,OAAO,CAAC;QAC/C,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { AxiosInstance } from "axios";
+export declare function registerTools(server: McpServer, client: AxiosInstance): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAiD3C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA8B5E"}

package/dist/tools.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { listProjects } from "./projects.js";
+import { getWorkItem, searchWorkItems } from "./workItems.js";
+function jsonResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * Full work item for MCP: `structuredContent` is the complete REST object.
+ * Preamble reminds clients that data lives under `fields`, `relations`, etc. — not just id/title/state.
+ */
+function workItemResult(item) {
+    const full = JSON.parse(JSON.stringify(item));
+    const fields = full.fields;
+    const fieldCount = fields && typeof fields === "object" && !Array.isArray(fields)
+        ? Object.keys(fields).length
+        : 0;
+    const relCount = Array.isArray(full.relations) ? full.relations.length : 0;
+    const topKeys = Object.keys(full).join(", ");
+    const preamble = "This is the full Azure DevOps GET work item response ($expand=all). " +
+        `Top-level keys: [${topKeys}]. ` +
+        `The "fields" object has ${fieldCount} entries (only non-empty fields are returned by the API). ` +
+        "Description/tags/HTML live under keys like System.Description, System.Tags. " +
+        `"relations" has ${relCount} link rows. ` +
+        "Use the JSON below in full — do not reduce to id/title/state/assignedTo only.\n\n";
+    return {
+        content: [
+            {
+                type: "text",
+                text: preamble + JSON.stringify(full, null, 2),
+            },
+        ],
+        structuredContent: full,
+    };
+}
+export function registerTools(server, client) {
+    server.tool("listProjects", "List team projects in the Azure DevOps collection. Uses AZURE_COLLECTION_URL if set, otherwise derives collection URL from AZURE_BASE_URL.", {}, async () => {
+        const projects = await listProjects(client);
+        return jsonResult(projects);
+    });
+    server.tool("getWorkItem", "Returns the complete Azure DevOps work item JSON from GET /_apis/wit/workitems/{id}?$expand=all. Includes the full `fields` map (System.Title, System.Description, System.Tags, custom fields, etc. — only fields with values are present), `relations`, `_links`, `rev`. This is NOT limited to id/title/state/assignedTo; read the `fields` object for description, tags, and links.", { id: z.number().int().positive() }, async ({ id }) => {
+        const item = await getWorkItem(client, id);
+        return workItemResult(item);
+    });
+    server.tool("searchWorkItems", 'Search work items whose title contains the given text (WIQL CONTAINS on System.Title). Returns { id, title, state }[].', { query: z.string() }, async ({ query }) => {
+        const items = await searchWorkItems(client, query);
+        return jsonResult(items);
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE9D,SAAS,UAAU,CAAC,OAAgB;IAClC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAmB;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAkB,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,UAAU,GACd,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAiC,CAAC,CAAC,MAAM;QACvD,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GACZ,sEAAsE;QACtE,oBAAoB,OAAO,KAAK;QAChC,2BAA2B,UAAU,4DAA4D;QACjG,8EAA8E;QAC9E,mBAAmB,QAAQ,cAAc;QACzC,mFAAmF,CAAC;IAEtF,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aAC/C;SACF;QACD,iBAAiB,EAAE,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,MAAqB;IACpE,MAAM,CAAC,IAAI,CACT,cAAc,EACd,4IAA4I,EAC5I,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;QAC5C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,aAAa,EACb,wXAAwX,EACxX,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,EACnC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACf,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,wHAAwH,EACxH,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EACrB,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACnD,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/workItems.d.ts

@@ -0,0 +1,16 @@
+import type { AxiosInstance } from "axios";
+/** Azure DevOps work item REST body from GET .../workitems/{id}?$expand=all */
+export type AzureWorkItem = Record<string, unknown>;
+/** Escape single quotes for WIQL string literals */
+export declare function escapeWiqlString(s: string): string;
+/**
+ * Full work item JSON from GET .../workitems/{id}?$expand=all (id, rev, fields, relations, _links, ...).
+ */
+export declare function getWorkItem(client: AxiosInstance, id: number): Promise<AzureWorkItem>;
+export interface WorkItemSearchRow {
+    id: number;
+    title: unknown;
+    state: unknown;
+}
+export declare function searchWorkItems(client: AxiosInstance, query: string): Promise<WorkItemSearchRow[]>;
+//# sourceMappingURL=workItems.d.ts.map

package/dist/workItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItems.d.ts","sourceRoot":"","sources":["../src/workItems.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpD,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AAOD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,aAAa,CAAC,CAUxB;AAoBD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAgCD,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAgC9B"}

package/dist/workItems.js

@@ -0,0 +1,72 @@
+import { devOpsApiVersion } from "./client.js";
+/** Escape single quotes for WIQL string literals */
+export function escapeWiqlString(s) {
+    return s.replace(/'/g, "''");
+}
+/** Team project root, e.g. https://host/Collection/Project — must match AZURE_BASE_URL. */
+function projectBaseUrl(client) {
+    return String(client.defaults.baseURL ?? "").replace(/\/+$/, "");
+}
+/**
+ * Full work item JSON from GET .../workitems/{id}?$expand=all (id, rev, fields, relations, _links, ...).
+ */
+export async function getWorkItem(client, id) {
+    const base = projectBaseUrl(client);
+    const url = `${base}/_apis/wit/workitems/${id}`;
+    const { data } = await client.get(url, {
+        params: {
+            $expand: "all",
+            "api-version": devOpsApiVersion(),
+        },
+    });
+    return data;
+}
+async function fetchWorkItemsBatch(client, ids) {
+    const map = new Map();
+    if (ids.length === 0) {
+        return map;
+    }
+    const base = projectBaseUrl(client);
+    const url = `${base}/_apis/wit/workitems`;
+    const { data } = await client.get(url, {
+        params: {
+            ids: ids.join(","),
+            fields: "System.Title,System.State",
+            "api-version": devOpsApiVersion(),
+        },
+    });
+    const items = data.value ?? [];
+    for (const item of items) {
+        const f = item.fields ?? {};
+        map.set(item.id, {
+            title: f["System.Title"],
+            state: f["System.State"],
+        });
+    }
+    return map;
+}
+export async function searchWorkItems(client, query) {
+    const trimmed = query.trim();
+    if (trimmed === "") {
+        return [];
+    }
+    const safe = escapeWiqlString(trimmed);
+    const wiql = `SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.Title] CONTAINS '${safe}'`;
+    const base = projectBaseUrl(client);
+    const url = `${base}/_apis/wit/wiql`;
+    const { data } = await client.post(url, { query: wiql }, { params: { "api-version": devOpsApiVersion() } });
+    const rawList = data.workItems ?? data.queryResult?.workItems ?? [];
+    const ids = rawList
+        .map((w) => w.id)
+        .filter((id) => typeof id === "number");
+    const details = await fetchWorkItemsBatch(client, ids);
+    const result = [];
+    for (const id of ids) {
+        const row = details.get(id);
+        if (row) {
+            result.push({ id, title: row.title, state: row.state });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=workItems.js.map

package/dist/workItems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workItems.js","sourceRoot":"","sources":["../src/workItems.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "azdo-onprem-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for self-hosted Azure DevOps Server",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ajithnow/azdo-onprem-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ajithnow/azdo-onprem-mcp/issues"
+  },
+  "homepage": "https://github.com/ajithnow/azdo-onprem-mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "azure-devops",
+    "azure-devops-server",
+    "work-items"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    ".env.example"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "azdo-onprem-mcp": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/server.js",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "axios": "^1.7.9",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3"
+  }
+}