Jira MCP Server with OAuth

# 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.**