# Jira MCP Server

> **Status: Getestet**

MCP Server for Jira Server/Data Center.

## Setup

1. Install dependencies:
```bash
cd JIRA-MCP
pip install -e .
```

2. Configure `config.json`:
```json
{
  "jira": {
    "base_url": "https://jira.example.com",
    "token": "YOUR_PERSONAL_ACCESS_TOKEN",
    "verify_ssl": true
  },
  "server": {
    "name": "jira-mcp",
    "version": "1.0.0"
  }
}
```

3. Get a Personal Access Token from Jira:
   - Go to Profile → Personal Access Tokens
   - Create a new token with appropriate permissions

## Claude Desktop Integration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "jira": {
      "command": "python",
      "args": ["-m", "jira_mcp.server"],
      "cwd": "/path/to/JIRA-MCP"
    }
  }
}
```

## Available Tools

### Issues
- `issue_get` - Get issue by key
- `issue_create` - Create new issue
- `issue_update` - Update issue
- `issue_delete` - Delete issue
- `issue_search` - JQL search
- `issue_transitions` - Get available transitions
- `issue_transition` - Change status

### Comments
- `comment_list` - List comments
- `comment_add` - Add comment
- `comment_update` - Edit comment
- `comment_delete` - Delete comment

### Attachments
- `attachment_list` - List attachments
- `attachment_add` - Upload file
- `attachment_delete` - Delete attachment

### Links
- `link_create` - Link issues
- `link_delete` - Remove link
- `remotelink_list` - List remote links
- `remotelink_add` - Add remote link
- `remotelink_delete` - Remove remote link

### Votes & Watchers
- `vote_add` / `vote_remove`
- `watcher_list` / `watcher_add` / `watcher_remove`

### Bulk
- `bulk_edit` - Edit multiple issues

### Projects
- `project_list` - List projects
- `project_get` - Get project details
- `project_components` - Get components
- `project_versions` - Get versions
- `project_roles` - Get roles

### Users
- `user_search` - Search users
- `user_picker` - Autocomplete
- `myself` - Current user info

### Types (readonly)
- `issuetype_list`
- `priority_list`
- `resolution_list`
- `linktype_list`

### JQL & Labels
- `jql_validate` - Validate JQL
- `label_list` - List labels