✨ Features

• 📋 Access JIRA Directly From Cursor
  • View your assigned issues without leaving your IDE
  • Get detailed information on specific issues with one command
  • Convert JIRA issues into local tasks seamlessly

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/Dsazz/mcp-jira.git
cd mcp-jira

# Install dependencies
bun install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

Configuration

Create a .env file with the following variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 Important Note About JIRA API Tokens

• Tokens may contain special characters, including the = sign
• Place the token on a single line in the .env file
• Do not add quotes around the token value
• Paste the token exactly as provided by Atlassian

🛠️ Development Tools

Code Quality Tools

The project uses Biome for code formatting and linting, replacing the previous ESLint setup. Biome provides:

• Fast, unified formatting and linting
• TypeScript-first tooling
• Zero configuration needed
• Consistent code style enforcement

To format and lint your code:

# Format code
bun format

# Check code for issues
bun check

# Type check
bun typecheck

MCP Inspector

# Run the inspector (no separate build step needed)
bun run inspect

bun run cleanup-ports

Integration with Claude Desktop

🔌 Integration with Cursor IDE

⚠️ Important: You must build the project with bun run build before integrating with Cursor IDE or Claude Desktop.

Add this MCP server to your Cursor IDE’s MCP configuration:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node", // or "bun"
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 Available Tools

JIRA Tools

📁 Project Structure

 src/
  ├── core/          # Core functionality and configurations
  ├── features/      # Feature implementations
  │   └── jira/      # JIRA API integration
  │       ├── api/         # JIRA API client
  │       ├── formatters/  # Response formatters
  │       └── tools/       # MCP tool implementations
  └── test/          # Test utilities

NPM Scripts

📝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

• Development workflow
• Branching strategy
• Commit message format
• Pull request process
• Code style guidelines

📘 Resources

• Model Context Protocol Documentation
• MCP TypeScript SDK
• MCP Specification
• MCP Inspector

📄 License

MIT © Stanislav Stepanenko