jira-mcp

Jira Cloud 向け Model Context Protocol サー... The text is a jira-mcp repository. Let's do final.

But before final, check "Model Context Protocol" link maybe kept exact. In output I'll include.

Need avoid Chinese? Japanese.

Let's final.# jira-mcp

Jira Cloud 向け Model Context Protocol サーバーです。課題とサブタスクの作成、課題の取得、JQL を使った検索、アジャイルボードとそのスイムランの参照、ワークフローを通じた課題の移動、コメント、ファイルの添付ができます。

Atlassian アカウントのメールアドレスとAPI トークンで認証するため、ヘッドレスで動作します。OAuth もブラウザのラウンドトリップも、対話的な同意もありません。

インストール

インストールするものはありません。MCP クライアントにパッケージを指定すれば、npx が取得します。

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:skurekjakub/jira-mcp#v1.0.0"],
      "env": {
        "NPM_CONFIG_ALLOW_GIT": "root",
        "JIRA_SITE": "your-team.atlassian.net",
        "JIRA_CLOUD_ID": "00000000-0000-0000-0000-000000000000",
        "JIRA_PROJECT_KEY": "ABC",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}

ビルド成果物はコミットされており、その中にランタイム依存関係が組み込まれているため、インストールではクローンとリンクだけで済みます。ビルドステップも、取得するパッケージも、承認が必要なインストールスクリプトもありません。

NPM_CONFIG_ALLOW_GIT

npm 12 は allow-git のデフォルトを none にしています。そのため、この設定がないと npm は EALLOWGIT でインストールを拒否します — "Fetching packages of type git have been disabled"。これをサーバーの env ブロックで設定すると、その例外は唯一のサブプロセスに限定され、マシン上の他のすべてのインストールでは git フェッチが無効のままになります。root はインストールされるパッケージ自体にのみ許可し、それが依存するものには許可しません。all は制限を完全に解除するものですが、ここでは必要ありません。npm 11 以前ではこの変数は無視されます。

代わりに一度だけインストールする

npx は起動のたびに git ref を解決し直すため、数秒とネットワークの往復がかかります。それを避けるには:

npm install -g --allow-git=root github:skurekjakub/jira-mcp

その後、args も NPM_CONFIG_ALLOW_GIT も付けずに "command": "jira-mcp" を使います。アップグレードは、そのコマンドを手動で再実行する形になります。

Related MCP server: JIRA MCP Server

設定

すべての設定は環境変数から取得します。設定ファイルは存在し、このサーバーは .env を読みません。MCP クライアントは上記の env ブロックでこれらの値を渡します。

クラウド ID は次のコマンドで確認できます:

curl -s https://your-team.atlassian.net/_edge/tenant_info

トークンを version control の外に置く

コミットする MCP 設定にはトークン自体を含めてはなりません。Claude Code は ${VAR} 参照を展開します。 command、args、env、url、headers 内で展開されるため、設定ファイルには変数名を記述し、値はシェルのプロファイルやコミットされない設定ファイルなどに置きます。

何も展開されない参照はエラーではありません。Claude Code はリテラルテキスト ${JIRA_API_TOKEN} をそのままサーバーに渡します。このサーバーは起動時にそのような値れを拒否し、Jira に送信して不透明な 401 を得る代わりに変数名を指摘します。

ツール

jira_create_issue

JIRA_PROJECT_KEY に課題を作成します。

jira_create_subtask

既存の課題の下にサブタスクを作成します。

jira_get_issue

課題の要約、説明、タイプ、ステータス、親、サブタスク、課題リンク、修正バージョンを取得します。

jira_search_issues

JQL で検索します。ページング対応です。

jira_get_board

アジャイルボードのレイアウト — コラム、クイックフィルター、スイムラインをそれぞれの JQL 付きで返します。jira_board_issues の前に実行して、そのツールが受け取る名前を確認してください。ボード ID は、ボード URL の boards/<id> の部分です。

スイムラインは GreenHopper の内部 API から取得されます。Atlassianはスイムラインでサポートされるエンドポイントを公開していません。

jira_board_issues

ボード上にある課題をスイムラインごとにグループ化して一覧返します。ボードの自身のフィルター、そのカンバンサブフィルター、指定されクイックフィルター、追加の JQL を適用したボードビューを再現します。

各課題は、スイムラインのうち、ボード順でそのクエリに一致する最初のスイムラインにだけ載ります。スイムラインのサブセットを要求しても、それより上にあるスイムラインが評価され、その課題に対する優先が維持されます。

jira_list_transitions

現在その課題で利用可能なワークフローのトランジションを一覧返します。トランジション名とIDはワークフロー固有です。jira_transition_issue の前にこれを呼んでください。

jira_transition_issue

課題をワークフローに沿って移動します。transitionName を、その課題で利用可能あるトランジションの一覧と大文字小文字を無視して照合します。一致するものがない場合は、有効なリストとともに失敗します。

jira_add_comment

コメントを追加します。本文は Jira wiki マークアップを使用します(h3. は見出し、{{code}} は中級 code, {code:lang}\…{code} はブ生ロック、bq. はブ匹配。実際の改行を使い、リテラルの \n エスケープは使わないでください。

jira_add_attachment

フルを添付します。ファイルは JIRA_ATTACHMENTS_DIR 内になければならず、そのディレクトを外れるファイル名は拒否されます。

トランスポート

デフォルトは stdio です。--transport http --port <n> は、同じツールをステートレスの Streamable HTTP トランスポートで /mcp に公開し、/health でヘルスチェックを提供します。

Development

npm install
npm test          # vitest
npm run lint      # tsc --noEmit
npm run build     # webpack -> dist/bundle.js

dist/bundle.js はコミット済みなので、インストールにビルドステップ不要ではい。CI が main への push ごとにこれをリビルドし、結果をコミットするため、src/ から逸れることはありません。

ライセンス

MIT