jira-datacenter-mcp 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,304 @@
+# Change Log
+
+## 0.2.0
+
+### Minor Changes
+
+- [`582a094`](https://github.com/MrRefactoring/atlassian-dc-mcp/commit/582a094960ba6d74453aabefa4ed44522ac07351) Thanks [@MrRefactoring](https://github.com/MrRefactoring)! - Allow the MCP servers to start and run without an API token, for Data Center instances that permit anonymous access. `*_API_TOKEN` is no longer required by config validation or the interactive `setup` CLI; when it's absent, requests are sent with no `Authorization` header instead of the previous placeholder-token workaround.
+
+### Patch Changes
+
+- Updated dependencies [[`582a094`](https://github.com/MrRefactoring/atlassian-dc-mcp/commit/582a094960ba6d74453aabefa4ed44522ac07351)]:
+  - datacenter-mcp-core@0.2.0
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+# [0.25.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.24.0...v0.25.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.24.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.23.0...v0.24.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.23.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.22.0...v0.23.0) (2026-06-18)
+
+### Features
+
+- **jira:** add customFields support to transitionIssue ([31799d5](https://github.com/b1ff/atlassian-dc-mcp/commit/31799d54afe640960c799c253c79d5dcec079d15))
+
+# [0.22.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.21.0...v0.22.0) (2026-06-18)
+
+### Features
+
+- **jira:** add jira_getIssueDevelopmentInfo tool ([f2e9f0d](https://github.com/b1ff/atlassian-dc-mcp/commit/f2e9f0d50d0ed65a8f214b6909ab3ef6fd3fd518))
+
+# [0.21.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.20.1...v0.21.0) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.20.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.20.0...v0.20.1) (2026-06-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.20.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.19.1...v0.20.0) (2026-06-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.19.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.19.0...v0.19.1) (2026-05-24)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.19.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.18.0...v0.19.0) (2026-04-27)
+
+### Features
+
+- **setup:** add CLI flags and non-interactive mode ([7de53f0](https://github.com/b1ff/atlassian-dc-mcp/commit/7de53f0b23704e84324b59bbcb8d830a1596f44a))
+
+# [0.18.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.1...v0.18.0) (2026-04-24)
+
+### Features
+
+- **setup:** validate credentials via product services with retry and friendly errors ([6056320](https://github.com/b1ff/atlassian-dc-mcp/commit/60563200e62b513fe8f3b5b4a190edfa1be25a13))
+
+## [0.17.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.17.0...v0.17.1) (2026-04-23)
+
+### Bug Fixes
+
+- prevent double-concatenation of API base path after setup CLI ([39cd1c7](https://github.com/b1ff/atlassian-dc-mcp/commit/39cd1c7c6dc6dc842b110c6650002487df534dd5))
+
+# [0.17.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.16.0...v0.17.0) (2026-04-23)
+
+### Features
+
+- add interactive setup CLI with secure credential storage ([f317903](https://github.com/b1ff/atlassian-dc-mcp/commit/f317903a9975b66442f54e520a5a1656a69d1a1b))
+
+# [0.16.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.15.0...v0.16.0) (2026-04-14)
+
+### Features
+
+- add keywords to package.json for npm search visibility ([0735f27](https://github.com/b1ff/atlassian-dc-mcp/commit/0735f27600d8215ba0c11c48916d3edc844f01b5))
+- improve supply-chain transparency (closes [#26](https://github.com/b1ff/atlassian-dc-mcp/issues/26)) ([98912b2](https://github.com/b1ff/atlassian-dc-mcp/commit/98912b26bddc4cafd847eb526fa8f76546576203))
+
+# [0.15.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.3...v0.15.0) (2026-04-07)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.14.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.2...v0.14.3) (2026-04-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.14.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.1...v0.14.2) (2026-04-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.14.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.14.0...v0.14.1) (2026-04-01)
+
+### Bug Fixes
+
+- use proper version for MCP server responces ([d1f5e5b](https://github.com/b1ff/atlassian-dc-mcp/commit/d1f5e5b59c592921f940916af008363414aa4c0e))
+
+# [0.14.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.13.0...v0.14.0) (2026-03-23)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.13.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.2...v0.13.0) (2026-03-21)
+
+### Features
+
+- add ability to specify external config file to MCP, to provide configuration to MCP without specifying credentials in the file ([c97d380](https://github.com/b1ff/atlassian-dc-mcp/commit/c97d38004ebc7e233ea276a36c2e233536d2d0ca))
+- **jira:** add configurable issue field projections ([06c50a9](https://github.com/b1ff/atlassian-dc-mcp/commit/06c50a978f8d2e7b0f8c9e8a6e7f7706dcc879ab))
+
+## [0.12.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.1...v0.12.2) (2026-03-21)
+
+### Bug Fixes
+
+- **jira:** address [#16](https://github.com/b1ff/atlassian-dc-mcp/issues/16) exposing labels and other hints through the customFields in the description of the tool. Update docs as well to reflect it. ([979a5fa](https://github.com/b1ff/atlassian-dc-mcp/commit/979a5fab8290f300c57a812be1cff4faa885a0ab))
+
+## [0.12.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.12.0...v0.12.1) (2026-03-21)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.12.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.2...v0.12.0) (2026-03-18)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.11.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.1...v0.11.2) (2026-03-12)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.11.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.11.0...v0.11.1) (2026-03-12)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.11.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.2...v0.11.0) (2026-03-09)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.10.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.1...v0.10.2) (2026-03-09)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.10.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.10.0...v0.10.1) (2026-03-09)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.10.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.12...v0.10.0) (2026-01-31)
+
+### Features
+
+- **jira:** add status transition tools ([47dbb0f](https://github.com/b1ff/atlassian-dc-mcp/commit/47dbb0f3ea522f44718ff02e4829d215968a740d))
+
+## [0.9.12](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.11...v0.9.12) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.11](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.10...v0.9.11) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.10](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.9...v0.9.10) (2026-01-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.9](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.8...v0.9.9) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.8](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.7...v0.9.8) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.7](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.6...v0.9.7) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.6](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.6) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.5](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.5) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.3...v0.9.4) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.2...v0.9.3) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.0...v0.9.2) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.9.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.9.0...v0.9.1) (2025-09-13)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.9.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.2...v0.9.0) (2025-09-13)
+
+### Features
+
+- preparation to publish to MCP registry ([1fdb772](https://github.com/b1ff/atlassian-dc-mcp/commit/1fdb772b419a5c472fafa2de4304e471471447c5))
+
+## [0.8.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.3) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.8.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.2) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.8.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.8.0...v0.8.1) (2025-09-06)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.8.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.7.0...v0.8.0) (2025-09-06)
+
+### Features
+
+- **jira:** introduce issue update functionality ([d9c20cb](https://github.com/b1ff/atlassian-dc-mcp/commit/d9c20cbcacc20a50131666a7276dedf46a5ee544))
+
+# [0.7.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.6.0...v0.7.0) (2025-08-03)
+
+### Features
+
+- **jira:** add support for custom fields when creating issues ([f931131](https://github.com/b1ff/atlassian-dc-mcp/commit/f9311314ee16ab7602c8ce016ff4f50a35bacdc3))
+
+## [0.6.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.6.0...v0.6.1) (2025-05-26)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.6.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.5.0...v0.6.0) (2025-05-26)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+# [0.5.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.5.0) (2025-05-14)
+
+### Features
+
+- **jira:** add support of api base path instead of only host to support paths based installations. ([e42cf70](https://github.com/b1ff/atlassian-dc-mcp/commit/e42cf70f885e2dda3e2cac5c02f697fbbb19cb98))
+
+# [0.4.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.4.0) (2025-05-03)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.3.5](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.4...v0.3.5) (2025-03-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.3.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.3...v0.3.4) (2025-03-08)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.3.2](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.3.1...v0.3.2) (2025-03-07)
+
+### Bug Fixes
+
+- **jira:** indicate clearly in tools descriptions and in the fields descriptions that it is JIRA Data Center edition with own formats and own instance details. ([5747bb1](https://github.com/b1ff/atlassian-dc-mcp/commit/5747bb14277937be41a0f84d8a785f665e99f26e))
+
+# [0.3.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.2.1...v0.3.0) (2025-03-03)
+
+### Features
+
+- add jira client ([0bcb329](https://github.com/b1ff/atlassian-dc-mcp/commit/0bcb32979a6c638dc759375de118a7d0eb3604fc))
+- use generated JIRA client instead of third-pary one. ([ff88084](https://github.com/b1ff/atlassian-dc-mcp/commit/ff88084c8bf5751c9288426e0c9aa73badc690de))
+
+## [0.2.1](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.2.0...v0.2.1) (2025-03-03)
+
+### Bug Fixes
+
+- trigger jira re-build and publish. ([835ea26](https://github.com/b1ff/atlassian-dc-mcp/commit/835ea26d33a8bad8d3319881e0fbd21fd4654573))
+
+# [0.2.0](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.6...v0.2.0) (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.1.6](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.5...v0.1.6) (2025-03-02)
+
+### Bug Fixes
+
+- trigger jira re-build and publish. ([02454af](https://github.com/b1ff/atlassian-dc-mcp/commit/02454affd0e286675dca30523d9f47d6ef2dcc29))
+
+## [0.1.4](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.3...v0.1.4) (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira
+
+## [0.1.3](https://github.com/b1ff/atlassian-dc-mcp/compare/v0.1.2...v0.1.3) (2025-03-02)
+
+### Bug Fixes
+
+- correct bin configurations and the relative paths. ([0bed1aa](https://github.com/b1ff/atlassian-dc-mcp/commit/0bed1aa86e94a1d0d589b43d1c50fad55025eb2c))
+
+## 0.1.2 (2025-03-02)
+
+### Bug Fixes
+
+- binary executable is now non compiled ones. ([18fa866](https://github.com/b1ff/atlassian-dc-mcp/commit/18fa8661d71e3b1246f35869bec0acefe7ac2df5))
+
+## 0.1.1 (2025-03-02)
+
+**Note:** Version bump only for package @atlassian-dc-mcp/jira

package/README.md

@@ -0,0 +1,250 @@
+# Atlassian Jira Data Center MCP
+
+This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Jira Data Center edition.
+
+## Interactive Setup
+
+The easiest way to configure this server is the built-in `setup` subcommand:
+
+```bash
+npx jira-datacenter-mcp setup
+```
+
+It prompts for host, API base path, default page size, and API token, then stores them in the most secure place available:
+
+- **macOS** — token in the login Keychain (service `atlassian-dc-mcp`, account `jira-token`); host / base path / page size in `~/.atlassian-dc-mcp/jira.env` (mode `0600`).
+- **Linux** — everything in `~/.atlassian-dc-mcp/jira.env` with POSIX mode `0600` (read/write for your user only).
+- **Windows** — everything in `%USERPROFILE%\.atlassian-dc-mcp\jira.env`. Node passes the mode bits but Windows ignores them, so the file inherits the ACL of your user profile directory (typically readable only by your user, SYSTEM, and Administrators).
+
+After setup, you can launch the server without any environment variables:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-jira-dc": {
+      "command": "npx",
+      "args": ["-y", "jira-datacenter-mcp"]
+    }
+  }
+}
+```
+
+Environment variables still override stored values — see [Configuration sources](#configuration-sources) below.
+
+### Scripted / non-interactive setup
+
+For CI, remote sessions, or shell scripts, pass values as flags and add `--non-interactive` to skip prompts:
+
+```bash
+npx jira-datacenter-mcp setup --non-interactive \
+  --host jira.example.com \
+  --token "$JIRA_TOKEN"
+```
+
+Available flags: `--host`/`-H`, `--api-base-path`/`-b`, `--token`/`-t`, `--default-page-size`/`-s`, `--non-interactive`/`-n`, `--help`/`-h`. In `--non-interactive` mode, missing values fall back to existing configuration and the run exits non-zero only if a host (or full-URL `--api-base-path`) cannot be resolved. The token is optional — omit it for anonymous access; an existing token is reused when `--token` is omitted. Run `npx jira-datacenter-mcp setup --help` for full usage.
+
+## Claude Desktop Configuration
+
+To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:
+
+macOS:
+```
+~/Library/Application Support/Claude/claude_desktop_config.json
+```
+
+Windows:
+```
+%APPDATA%\Claude\claude_desktop_config.json
+```
+
+```json
+{
+  "mcpServers": {
+    "atlassian-jira-dc": {
+      "command": "npx",
+      "args": ["-y", "jira-datacenter-mcp"],
+      "env": {
+        "JIRA_HOST": "your-jira-host",
+        "JIRA_API_TOKEN": "your-token"
+      }
+    }
+  }
+}
+```
+
+To reuse one shared dotenv file across multiple tools or MCP hosts, point the server at an absolute file path:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-jira-dc": {
+      "command": "npx",
+      "args": ["-y", "jira-datacenter-mcp"],
+      "env": {
+        "ATLASSIAN_DC_MCP_CONFIG_FILE": "/Users/your-user/.config/atlassian-dc-mcp.env"
+      }
+    }
+  }
+}
+```
+
+Windows example:
+
+```json
+{
+  "mcpServers": {
+    "atlassian-jira-dc": {
+      "command": "npx",
+      "args": ["-y", "jira-datacenter-mcp"],
+      "env": {
+        "ATLASSIAN_DC_MCP_CONFIG_FILE": "C:\\\\Users\\\\your-user\\\\AppData\\\\Roaming\\\\atlassian-dc-mcp.env"
+      }
+    }
+  }
+}
+```
+
+Note: Set `JIRA_HOST` variable only to domain + port without a protocol (e.g., `your-instance.atlassian.net`). The https protocol is assumed.
+
+Alternatively, you can use `JIRA_API_BASE_PATH` instead of `JIRA_HOST` to specify the complete API base URL including protocol (e.g., `https://your-instance.atlassian.net/rest`). Note that the `/api/2/search/` part is static and added automatically in the code, so you don't need to include it in the `JIRA_API_BASE_PATH` value.
+
+## Features
+
+- Search for issues using JQL (Jira Query Language)
+- Get issue details by key
+- Get issue comments
+- Create and update issues
+- Add comments to issues
+
+## Setup
+
+1. Install dependencies:
+   ```
+   pnpm install
+   ```
+
+2. Create a `.env` file in the packages/jira directory, or put the same values in a shared dotenv file and set `ATLASSIAN_DC_MCP_CONFIG_FILE` to its absolute path:
+   ```
+   JIRA_HOST=your-jira-instance.atlassian.net
+   # OR alternatively use
+   # JIRA_API_BASE_PATH=https://your-jira-instance.atlassian.net/rest
+   # Note: /api/latest/ is added automatically, do not include it
+   # Optional: omit for anonymous access if your instance allows unauthenticated reads
+   JIRA_API_TOKEN=your-personal-access-token
+
+   # Optional: default page size for paginated read tools (fallback: 25)
+   JIRA_DEFAULT_PAGE_SIZE=25
+   ```
+
+   See [Configuration sources](#configuration-sources) for the full precedence chain.
+
+   To create a personal access token:
+  - In Jira, select your profile picture at the top right
+  - Select **Personal Access Tokens**
+  - Select **Create token** and give it a name
+  - Copy the token and store it securely (you won't be able to see it again)
+
+## Configuration sources
+
+Each key is resolved by walking these sources in priority order and taking the first non-empty value:
+
+| Priority | Source | Reads | Written by `setup` |
+|---------:|--------|-------|--------------------|
+| 100 | `process.env` (`JIRA_HOST`, `JIRA_API_BASE_PATH`, `JIRA_API_TOKEN`, `JIRA_DEFAULT_PAGE_SIZE`) | all keys | — |
+| 80  | env file — `ATLASSIAN_DC_MCP_CONFIG_FILE` (absolute path) or `./.env` | all keys | — |
+| 60  | home file — `~/.atlassian-dc-mcp/jira.env` on macOS/Linux, `%USERPROFILE%\.atlassian-dc-mcp\jira.env` on Windows (mode `0600` on POSIX; Windows inherits the user-profile ACL) | all keys | host, apiBasePath, defaultPageSize (always); token (non-darwin or keychain fallback) |
+| 40  | macOS Keychain — service `atlassian-dc-mcp`, account `jira-token` | token only | token (darwin only) |
+
+`setup` always writes non-secret fields to the home file and tries the keychain first for the token. If a higher-priority source shadows the value being saved, `setup` prints a warning so you can unset the env var.
+
+## Usage
+
+Start the MCP server:
+
+```
+pnpm build
+```
+
+Or for development with auto-reload:
+
+```
+pnpm dev
+```
+
+### Available Tools
+
+#### 1. jira_searchIssues
+
+Search for JIRA issues using JQL in the JIRA Data Center edition instance.
+
+Parameters:
+- `jql` (string, required): JIRA Query Language search string
+- `expand` (array, optional): Additional response sections to expand, such as `renderedFields`, `names`, or `schema`
+- `startAt` (number, optional): Starting index for pagination
+- `maxResults` (number, optional): Maximum number of results to return. Defaults to `JIRA_DEFAULT_PAGE_SIZE` or `25`.
+- `fields` (array, optional): Issue field names to return. When omitted, the tool uses a moderate-detail default field set.
+
+#### 2. jira_getIssue
+
+Get details of a JIRA issue by its key from the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `expand` (string, optional): Comma-separated response sections to expand, such as `renderedFields`, `changelog`, or `transitions`
+- `fields` (array, optional): Issue field names to return. When omitted, the tool uses the search default field set plus `parent` and `subtasks`.
+
+#### 3. jira_getIssueComments
+
+Get comments for a JIRA issue from the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `expand` (string, optional): Comma-separated comment expansions, such as `renderedBody`
+- `maxResults` (number, optional): Maximum number of comments to return. Defaults to `JIRA_DEFAULT_PAGE_SIZE` or `25`.
+- `startAt` (number, optional): Starting comment offset for pagination
+
+#### 4. jira_createIssue
+
+Create a new issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `projectId` (string, required): Project key (despite the parameter name, e.g., "PROJ")
+- `summary` (string, required): Issue summary
+- `description` (string, required): Issue description in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
+- `issueTypeId` (string, required): ID of the issue type
+- `customFields` (object, optional): Additional JIRA fields merged into the issue payload. Can be used for custom fields and standard fields such as `labels`. Example: `{"labels":["urgent","bug"],"customfield_10001":"Custom Value"}`
+
+#### 5. jira_updateIssue
+
+Update an existing issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `summary` (string, optional): New issue summary
+- `description` (string, optional): New issue description in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
+- `issueTypeId` (string, optional): New issue type ID
+- `customFields` (object, optional): Additional JIRA fields merged into the update payload. Can be used for custom fields and standard fields such as `labels`. Example: `{"labels":["urgent","bug"],"customfield_10001":"Custom Value"}`
+
+#### 6. jira_postIssueComment
+
+Add a comment to a JIRA issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `comment` (string, required): Comment text in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
+
+#### 7. jira_getTransitions
+
+Get the available workflow transitions for a JIRA issue in the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+
+#### 8. jira_transitionIssue
+
+Transition a JIRA issue to a new status in the JIRA Data Center edition instance.
+
+Parameters:
+- `issueKey` (string, required): The issue key (e.g., "PROJECT-123")
+- `transitionId` (string, required): Transition ID returned by `jira_getTransitions`
+- `fields` (object, optional): Additional fields required by the transition screen

package/bin/run.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+const sub = process.argv[2];
+if (sub === 'setup') {
+  await import('../build/setup.js');
+} else {
+  await import('../build/index.js');
+}

package/build/__tests__/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/build/__tests__/config.test.d.ts.map

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

package/build/__tests__/config.test.js

@@ -0,0 +1,49 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+describe('Jira config', () => {
+    const originalEnv = process.env;
+    const originalCwd = process.cwd();
+    let tempDir;
+    beforeEach(() => {
+        jest.resetModules();
+        process.env = { ...originalEnv };
+        delete process.env.ATLASSIAN_DC_MCP_CONFIG_FILE;
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'jira-config-'));
+        process.chdir(tempDir);
+    });
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        process.chdir(originalCwd);
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+    });
+    it('uses the configured page size when the env var is a positive integer', async () => {
+        process.env.JIRA_DEFAULT_PAGE_SIZE = '40';
+        const { getDefaultPageSize } = await import('../config.js');
+        expect(getDefaultPageSize()).toBe(40);
+    });
+    it('falls back to 25 when the env var is invalid', async () => {
+        process.env.JIRA_DEFAULT_PAGE_SIZE = 'invalid';
+        const { getDefaultPageSize } = await import('../config.js');
+        expect(getDefaultPageSize()).toBe(25);
+    });
+    it('reads the page size from the shared config file', async () => {
+        const sharedConfigPath = path.join(tempDir, 'shared.env');
+        fs.writeFileSync(sharedConfigPath, 'JIRA_HOST=file-host\nJIRA_API_TOKEN=file-token\nJIRA_DEFAULT_PAGE_SIZE=35\n');
+        process.env.ATLASSIAN_DC_MCP_CONFIG_FILE = sharedConfigPath;
+        const { getDefaultPageSize, getJiraRuntimeConfig } = await import('../config.js');
+        expect(getDefaultPageSize()).toBe(35);
+        expect(getJiraRuntimeConfig().token).toBe('file-token');
+    });
+    it('keeps env values higher priority than the shared config file', async () => {
+        const sharedConfigPath = path.join(tempDir, 'shared.env');
+        fs.writeFileSync(sharedConfigPath, 'JIRA_HOST=file-host\nJIRA_API_TOKEN=file-token\nJIRA_DEFAULT_PAGE_SIZE=35\n');
+        process.env.ATLASSIAN_DC_MCP_CONFIG_FILE = sharedConfigPath;
+        process.env.JIRA_DEFAULT_PAGE_SIZE = '45';
+        const { getDefaultPageSize } = await import('../config.js');
+        expect(getDefaultPageSize()).toBe(45);
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/build/__tests__/config.test.js.map

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

package/build/__tests__/jira-runtime-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jira-runtime-config.test.d.ts.map

package/build/__tests__/jira-runtime-config.test.d.ts.map

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