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
