SkillPedia Skills Encyclopedia
中文 EN

MCP 服务 2026-09-19 10:20 UTC

mcp-atlassian

由提交人 ulikoenig 提交,主要更新类型为:问题缺陷修复与稳定性提升。提交说明:fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas (#1685)。解决了已知运行时异常与边界错误,提升系统稳定性。

ulikoenig 0a5d242 sooperset/mcp-atlassian

Commit提交信息原文

fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas (#1685)

* fix(jira): sort DEFAULT_READ_JIRA_FIELDS before joining into tool schemas

get_issue, search, get_board_issues and get_sprint_issues each build the
default value of their "fields" parameter with
",".join(DEFAULT_READ_JIRA_FIELDS). DEFAULT_READ_JIRA_FIELDS is a set, so
its iteration order depends on the interpreter's (randomised) hash seed.
Two worker processes running the exact same code therefore advertise two
different tool schemas for the same tool, purely because they happen to
have different hash seeds.

This is externally visible: an MCP client that fingerprints/caches the
tool catalog can see the schema "change" between two calls that land on
different workers of the same deployment, even though nothing about the
tool changed. Observed in the wild against a stateless, multi-worker
deployment: GitHub Copilot CLI aborted a jira_search call with a "tool
catalog changed" error, while Claude Code tolerated the same drift.

Fixes #1662. Sort the fields before joining at every call site (the four
tool signatures in servers/jira.py, plus the two runtime fallbacks in
jira/issues.py and jira/search.py) so the emitted string is deterministic
across processes and hash seeds. DEFAULT_READ_JIRA_FIELDS itself stays a
set (equality/membership checks elsewhere rely on that), only the
string serialization is now sorted.

Added a regression test that spawns fresh interpreters under several
PYTHONHASHSEED values and asserts all four affected tools report the same
"fields" default - this fails on main (each seed can produce a different
order) and passes with the fix.

* test(jira): cover deterministic runtime defaults

Reported-by: ulikoenig

---------

Co-authored-by: mcp-atlassian-maintainer[bot] <300134992+mcp-atlassian-maintainer[bot]@users.noreply.github.com>