mcp-jira-stdio 1.2.0 → 1.4.0

package/README.md

@@ -6,11 +6,9 @@
 [![npm version](https://badge.fury.io/js/mcp-jira-stdio.svg)](https://www.npmjs.com/package/mcp-jira-stdio)
 [![MCP Server](https://img.shields.io/badge/MCP-Server-blue)](https://glama.ai/mcp/servers)
 
-[![Docker Pulls](https://img.shields.io/docker/pulls/freema/mcp-jira-stdio)](https://hub.docker.com/r/freema/mcp-jira-stdio)
 [![CI](https://github.com/freema/mcp-jira-stdio/actions/workflows/ci.yml/badge.svg)](https://github.com/freema/mcp-jira-stdio/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/freema/mcp-jira-stdio/branch/main/graph/badge.svg)](https://codecov.io/gh/freema/mcp-jira-stdio)
 [![GitHub issues](https://img.shields.io/github/issues/freema/mcp-jira-stdio)](https://github.com/freema/mcp-jira-stdio/issues)
-[![Docker Image Size](https://img.shields.io/docker/image-size/freema/mcp-jira-stdio/latest)](https://hub.docker.com/r/freema/mcp-jira-stdio)
 
 <a href="https://glama.ai/mcp/servers/@freema/mcp-jira-stdio">
   <img width="380" height="200" src="https://glama.ai/mcp/servers/@freema/mcp-jira-stdio/badge" />
@@ -212,6 +210,11 @@ npm run inspector:dev
 task inspector:dev
 ```
 
+Notes:
+
+- Startup no longer blocks on Jira connectivity. If Jira env vars are missing, the server still starts and lists tools; tool calls will fail with a clear auth error until you set `JIRA_BASE_URL`, `JIRA_EMAIL`, and `JIRA_API_TOKEN`.
+- Connection testing runs only in development/test (`NODE_ENV=development` or `test`). Failures are logged but do not terminate the server, so the inspector can still display tools.
+
 ### Testing
 
 ```bash
@@ -314,6 +317,15 @@ task inspector:dev
 task check
 ```
 
+If the inspector shows an SSE error and the server exits immediately, ensure you are not forcing an early exit with invalid credentials. With the current behavior, the server should not exit on missing credentials; export your Jira vars to exercise the tools:
+
+```bash
+export JIRA_BASE_URL="https://your-instance.atlassian.net"
+export JIRA_EMAIL="your-email@example.com"
+export JIRA_API_TOKEN="your-api-token"
+npm run inspector
+```
+
 ## 🔍 Environment Variables
 
 | Variable         | Required | Description       | Example                         |

package/dist/index.js

@@ -42,7 +42,7 @@ var require_package = __commonJS({
   "node_modules/dotenv/package.json"(exports, module) {
     module.exports = {
       name: "dotenv",
-      version: "17.2.1",
+      version: "17.2.3",
       description: "Loads environment variables from .env file",
       main: "lib/main.js",
       types: "lib/main.d.ts",
@@ -64,8 +64,8 @@ var require_package = __commonJS({
         "dts-check": "tsc --project tests/types/tsconfig.json",
         lint: "standard",
         pretest: "npm run lint && npm run dts-check",
-        test: "tap run --allow-empty-coverage --disable-coverage --timeout=60000",
-        "test:coverage": "tap run --show-full-coverage --timeout=60000 --coverage-report=text --coverage-report=lcov",
+        test: "tap run tests/**/*.js --allow-empty-coverage --disable-coverage --timeout=60000",
+        "test:coverage": "tap run tests/**/*.js --show-full-coverage --timeout=60000 --coverage-report=text --coverage-report=lcov",
         prerelease: "npm test",
         release: "standard-version"
       },
@@ -118,9 +118,12 @@ var require_main = __commonJS({
       "\u{1F510} encrypt with Dotenvx: https://dotenvx.com",
       "\u{1F510} prevent committing .env to code: https://dotenvx.com/precommit",
       "\u{1F510} prevent building .env in docker: https://dotenvx.com/prebuild",
-      "\u{1F4E1} observe env with Radar: https://dotenvx.com/radar",
-      "\u{1F4E1} auto-backup env with Radar: https://dotenvx.com/radar",
-      "\u{1F4E1} version env with Radar: https://dotenvx.com/radar",
+      "\u{1F4E1} add observability to secrets: https://dotenvx.com/ops",
+      "\u{1F465} sync secrets across teammates & machines: https://dotenvx.com/ops",
+      "\u{1F5C2}\uFE0F backup and recover secrets: https://dotenvx.com/ops",
+      "\u2705 audit secrets and track compliance: https://dotenvx.com/ops",
+      "\u{1F504} add secrets lifecycle management: https://dotenvx.com/ops",
+      "\u{1F511} add access controls to secrets: https://dotenvx.com/ops",
       "\u{1F6E0}\uFE0F  run anywhere with `dotenvx run -- yourcommand`",
       "\u2699\uFE0F  specify custom .env file path with { path: '/custom/path/.env' }",
       "\u2699\uFE0F  enable debug logging with { debug: true }",
@@ -436,7 +439,7 @@ var require_package2 = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "mcp-jira-stdio",
-      version: "1.2.0",
+      version: "1.4.0",
       description: "Model Context Protocol (MCP) server for Jira API integration",
       author: "graslt",
       license: "MIT",
@@ -694,18 +697,6 @@ async function makeJiraRequest(config, retryConfig = {
   }
   throw lastError;
 }
-async function testConnection() {
-  try {
-    await makeJiraRequest({
-      method: "GET",
-      url: "/myself"
-    });
-    return true;
-  } catch (error) {
-    log.error("Connection test failed:", error);
-    return false;
-  }
-}
 function validateInput(schema, input) {
   try {
     return schema.parse(input);
@@ -727,13 +718,10 @@ function isValidProjectKey(key) {
 function sanitizeJQL(jql) {
   return jql.replace(/[<>"'`]/g, "").replace(/\s+/g, " ").trim();
 }
-function validatePagination(startAt, maxResults) {
-  if (startAt < 0) {
-    throw new Error("startAt must be non-negative");
-  }
-  if (maxResults < 1 || maxResults > 100) {
-    throw new Error("maxResults must be between 1 and 100");
-  }
+function extractIssueKey(input) {
+  if (typeof input !== "string") return null;
+  const match = input.match(/[A-Z][A-Z0-9]*-\d+/);
+  return match ? match[0] : null;
 }
 
 // src/types/tools.ts
@@ -750,8 +738,10 @@ var GetIssueInputSchema = z.object({
 });
 var SearchIssuesInputSchema = z.object({
   jql: z.string().min(1).describe("JQL query string"),
-  startAt: z.number().min(0).default(0).describe("Index of first result to return"),
-  maxResults: z.number().min(1).max(100).default(50).describe("Maximum number of results to return"),
+  nextPageToken: z.string().optional().describe(
+    "Token for pagination. Omit for first page, use value from previous response for next page."
+  ),
+  maxResults: z.number().min(1).max(100).default(50).describe("Maximum number of results to return per page"),
   fields: z.array(z.string()).optional().describe("Specific fields to retrieve"),
   expand: z.array(z.string()).optional().describe("Additional details to include")
 });
@@ -780,8 +770,10 @@ var UpdateIssueInputSchema = z.object({
   returnIssue: z.boolean().optional().describe("When false, skip fetching full issue after update")
 });
 var GetMyIssuesInputSchema = z.object({
-  startAt: z.number().min(0).default(0).describe("Index of first result to return"),
-  maxResults: z.number().min(1).max(100).default(50).describe("Maximum number of results to return"),
+  nextPageToken: z.string().optional().describe(
+    "Token for pagination. Omit for first page, use value from previous response for next page."
+  ),
+  maxResults: z.number().min(1).max(100).default(50).describe("Maximum number of results to return per page"),
   fields: z.array(z.string()).optional().describe("Specific fields to retrieve"),
   expand: z.array(z.string()).optional().describe("Additional details to include")
 });
@@ -968,14 +960,15 @@ async function getIssue(issueKey, options = {}) {
   return await makeJiraRequest(config);
 }
 async function searchIssues(options) {
-  const { jql, startAt = 0, maxResults = 50 } = options;
-  validatePagination(startAt, maxResults);
+  const { jql, nextPageToken, maxResults = 50 } = options;
   const sanitizedJql = sanitizeJQL(jql);
   const data = {
     jql: sanitizedJql,
-    startAt,
     maxResults
   };
+  if (nextPageToken) {
+    data.nextPageToken = nextPageToken;
+  }
   if (options.fields) {
     data.fields = options.fields;
   }
@@ -984,7 +977,7 @@ async function searchIssues(options) {
   }
   const config = {
     method: "POST",
-    url: "/search",
+    url: "/search/jql",
     data
   };
   return await makeJiraRequest(config);
@@ -1059,9 +1052,9 @@ async function getMyIssues(options = {}) {
   const jql = `assignee = currentUser() ORDER BY updated DESC`;
   const searchParams = {
     jql,
-    startAt: options.startAt || 0,
     maxResults: options.maxResults || 50
   };
+  if (options.nextPageToken !== void 0) searchParams.nextPageToken = options.nextPageToken;
   if (options.fields !== void 0) searchParams.fields = options.fields;
   if (options.expand !== void 0) searchParams.expand = options.expand;
   return await searchIssues(searchParams);
@@ -1321,9 +1314,18 @@ function formatSearchResultsResponse(result) {
   const rangeStart = result.startAt + 1;
   const rangeEnd = Math.min(result.startAt + result.maxResults, result.total);
   const showRangeInline = result.total > result.maxResults || result.startAt > 0;
-  const paginationInfo = showRangeInline ? `
+  let paginationInfo = "";
+  if (showRangeInline) {
+    paginationInfo = `
 
-*Showing ${rangeStart}-${rangeEnd} of ${result.total} results*` : "";
+*Showing ${rangeStart}-${rangeEnd} of ${result.total} results*`;
+  }
+  if (result.nextPageToken && !result.isLast) {
+    paginationInfo += `
+*Next page token: \`${result.nextPageToken}\`*`;
+  } else if (result.isLast) {
+    paginationInfo += "\n*This is the last page of results*";
+  }
   return {
     content: [
       {
@@ -1639,7 +1641,8 @@ var getIssueTool = {
 async function handleGetIssue(input) {
   try {
     const validated = validateInput(GetIssueInputSchema, input);
-    const key = (validated.issueKey || "").trim();
+    const trimmedInput = (validated.issueKey || "").trim();
+    const key = extractIssueKey(trimmedInput) || trimmedInput;
     log4.info(`Getting issue ${key}...`);
     const getParams = {};
     if (validated.expand !== void 0) getParams.expand = validated.expand;
@@ -1657,7 +1660,7 @@ async function handleGetIssue(input) {
 var log5 = createLogger("tool:search-issues");
 var searchIssuesTool = {
   name: TOOL_NAMES.SEARCH_ISSUES,
-  description: 'Search for Jira issues using JQL. Supports complex queries with pagination and field selection. Examples: "project = PROJECT AND status = Open", "assignee = currentUser()".',
+  description: 'Search for Jira issues using JQL. Supports complex queries with pagination and field selection. Examples: "project = PROJECT AND status = Open", "assignee = currentUser()". For pagination, use nextPageToken from previous response.',
   inputSchema: {
     type: "object",
     properties: {
@@ -1665,15 +1668,13 @@ var searchIssuesTool = {
         type: "string",
         description: 'JQL query string (e.g., "project = PROJECT AND status = Open")'
       },
-      startAt: {
-        type: "number",
-        description: "Index of first result to return (for pagination)",
-        minimum: 0,
-        default: 0
+      nextPageToken: {
+        type: "string",
+        description: "Token for pagination. Omit for first page, use value from previous response for next page."
       },
       maxResults: {
         type: "number",
-        description: "Maximum number of results to return",
+        description: "Maximum number of results to return per page",
         minimum: 1,
         maximum: 100,
         default: 50
@@ -1700,7 +1701,7 @@ async function handleSearchIssues(input) {
     const searchParams = {
       jql: validated.jql
     };
-    if (validated.startAt !== void 0) searchParams.startAt = validated.startAt;
+    if (validated.nextPageToken !== void 0) searchParams.nextPageToken = validated.nextPageToken;
     if (validated.maxResults !== void 0) searchParams.maxResults = validated.maxResults;
     if (validated.fields !== void 0) searchParams.fields = validated.fields;
     if (validated.expand !== void 0) searchParams.expand = validated.expand;
@@ -1717,19 +1718,17 @@ async function handleSearchIssues(input) {
 var log6 = createLogger("tool:get-my-issues");
 var getMyIssuesTool = {
   name: TOOL_NAMES.GET_MY_ISSUES,
-  description: "Retrieves issues assigned to current user, sorted by most recently updated first. Supports pagination and field selection.",
+  description: "Retrieves issues assigned to current user, sorted by most recently updated first. Supports pagination and field selection. For pagination, use nextPageToken from previous response.",
   inputSchema: {
     type: "object",
     properties: {
-      startAt: {
-        type: "number",
-        description: "Index of first result to return (for pagination)",
-        minimum: 0,
-        default: 0
+      nextPageToken: {
+        type: "string",
+        description: "Token for pagination. Omit for first page, use value from previous response for next page."
       },
       maxResults: {
         type: "number",
-        description: "Maximum number of results to return",
+        description: "Maximum number of results to return per page",
         minimum: 1,
         maximum: 100,
         default: 50
@@ -1754,7 +1753,7 @@ async function handleGetMyIssues(input) {
     const validated = validateInput(GetMyIssuesInputSchema, input);
     log6.info("Getting issues assigned to current user...");
     const getParams = {};
-    if (validated.startAt !== void 0) getParams.startAt = validated.startAt;
+    if (validated.nextPageToken !== void 0) getParams.nextPageToken = validated.nextPageToken;
     if (validated.maxResults !== void 0) getParams.maxResults = validated.maxResults;
     if (validated.fields !== void 0) getParams.fields = validated.fields;
     if (validated.expand !== void 0) getParams.expand = validated.expand;
@@ -2291,25 +2290,22 @@ var allTools = [
 async function main() {
   const isDryRun = (process.env.DRY_RUN || "").toLowerCase() === "1" || (process.env.DRY_RUN || "").toLowerCase() === "true";
   if (!isDryRun) {
-    try {
-      const auth = validateAuth();
-      console.error(`\u{1F510} Authenticated as: ${auth.email}`);
-      console.error(`\u{1F310} Jira instance: ${auth.baseUrl}`);
-      console.error("\u{1F50D} Testing connection to Jira...");
-      const ok = await testConnection();
-      if (!ok) {
-        console.error("\u274C Connection to Jira failed");
-        process.exit(1);
-        return;
+    const hasAuthVars = Boolean(
+      process.env.JIRA_BASE_URL && process.env.JIRA_EMAIL && process.env.JIRA_API_TOKEN
+    );
+    if (hasAuthVars) {
+      try {
+        const auth = validateAuth();
+        console.error(`\u{1F510} Authenticated as: ${auth.email}`);
+        console.error(`\u{1F310} Jira instance: ${auth.baseUrl}`);
+      } catch (error) {
+        console.error("\u26A0\uFE0F  Invalid Jira credentials:", error.message);
       }
-      console.error("\u2705 Connection to Jira successful");
-    } catch (error) {
-      console.error("\u274C Authentication Error:", error.message);
-      process.exit(1);
-      return;
+    } else {
+      console.error("\u26A0\uFE0F  Jira env vars missing (JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN)");
     }
   } else {
-    console.error("\u{1F9EA} DRY_RUN=1 set \u2014 skipping Jira auth and connection test");
+    console.error("\u{1F9EA} DRY_RUN=1 set \u2014 skipping Jira auth check");
   }
   let version = "0.0.0";
   try {