README

mcp-server-jira

JIRA Cloud REST API v3 を利用した MCP (Model Context Protocol) サーバー。 Claude Code / Claude Desktop から JIRA の課題検索・作成・更新・コメント追加などの基本操作を実行できます。

セットアップ

npm install
npm run build

環境変数

.env.example を .env にコピーして値を設定してください。

変数名	説明
`JIRA_BASE_URL`	JIRA Cloud の URL (例: `https://your-domain.atlassian.net`)
`JIRA_EMAIL`	JIRA アカウントのメールアドレス
`JIRA_API_TOKEN`	Atlassian API トークン

利用可能なツール

ツール名	説明
`search_issues`	JQL でチケットを検索
`get_issue`	課題の詳細を取得
`create_issue`	新しい課題を作成
`update_issue`	課題のフィールドを更新
`add_comment`	課題にコメントを追加
`get_transitions`	利用可能なステータス遷移を取得
`transition_issue`	課題のステータスを変更
`assign_issue`	課題の担当者を変更
`list_projects`	プロジェクト一覧を取得

Claude Code での設定

~/.claude.json の mcpServers に追加:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/mcp-server-jira/dist/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

テスト

# ユニットテスト
npm test

# 接続テスト (要 .env 設定)
npm run test:integration

# 全テスト
npm run test:all

mcp-server-jira

README

mcp-server-jira

セットアップ

環境変数

利用可能なツール

Claude Code での設定

テスト

Recommended Servers