# Jira MCP Server with OAuth Authentication

🚀 **Smithery-Compatible MCP Server** for seamless Jira integration with browser OAuth authentication.

## ✨ Key Features

- 🔐 **Browser OAuth Flow** - No manual API token management
- 🏪 **Smithery Marketplace Ready** - One-click installation
- ⚡ **Auto-Configuration** - Claude Desktop configured automatically
- 🛠️ **Complete Tool Suite** - Issue management, search, projects
- 🔒 **Secure** - OAuth tokens handled safely
- 📱 **User-Friendly** - Config UI in Smithery

## 🎯 User Experience

```
Install from Smithery → Config UI → Browser Login → Done!
(30 seconds total setup time)
```

### Installation Flow:
1. **Install** from Smithery marketplace
2. **Configure** Jira URL and email in Smithery UI
3. **Open Claude Desktop** (auto-configured)
4. **Run** `start_oauth` tool
5. **Login** via browser
6. **Ready!** All Jira tools available

## 🛠️ Available Tools

- `oauth_status` - Check authentication status
- `start_oauth` - Launch browser authentication
- `test_jira_connection` - Verify connection
- `jira_get_issue` - Get issue details
- `jira_search` - Search with JQL
- `list_projects` - List accessible projects
- `help` - Complete usage guide

## 🚀 Deployment

### For Smithery Marketplace:
1. Upload this repository to Smithery
2. Configure OAuth app with Atlassian
3. Set environment variables in Smithery
4. Publish to marketplace

### OAuth App Setup:
- **Authorization callback URL**: `${SMITHERY_HOSTNAME}/oauth/callback`
- **Scopes**: `read:jira-user`, `read:jira-work`, `write:jira-work`

## 💻 Development

```bash
# Install dependencies
npm install

# Build TypeScript
npm run build

# Start development server
npm run dev-oauth

# Test OAuth flow
npm run test-oauth
```

## 📋 Environment Variables

Required for Smithery deployment:

```
OAUTH_CLIENT_ID=your_atlassian_oauth_client_id
OAUTH_CLIENT_SECRET=your_atlassian_oauth_client_secret
THIS_HOSTNAME=https://your-smithery-hostname
PORT=3000
```

## 🔧 Technical Details

- **Runtime**: Node.js 18+
- **Transport**: HTTP (Smithery-compatible)
- **Authentication**: Atlassian OAuth 2.0
- **Framework**: Express.js with MCP SDK
- **Token Storage**: In-memory (production: Redis recommended)

## 📜 License

MIT License - see LICENSE file for details

---

**Built for seamless Jira integration with Claude Desktop via Smithery marketplace.**