# mcp-server-jira

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

## セットアップ

```bash
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 トークン](https://id.atlassian.com/manage-profile/security/api-tokens) |

## 利用可能なツール

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

## Claude Code での設定

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

```json
{
  "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"
      }
    }
  }
}
```

## テスト

```bash
# ユニットテスト
npm test

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

# 全テスト
npm run test:all
```