Jira Mcp

什麼是 Jira-MCP？

Jira-MCP（模型控制協議）是一個基於 Go 的連接器，旨在實現 AI 助手（如 Claude）與 Atlassian Jira 之間的無縫互動。這個工具允許 AI 模型執行各種 Jira 操作，包括問題管理、衝刺規劃和工作流程轉換，有效提升生產力並簡化項目管理流程。

Jira-MCP 的特點

AI 集成：Jira-MCP 使 AI 助手能夠與 Jira 互動，實現自動化任務管理和提高效率。
問題管理：用戶可以通過 AI 界面直接創建、更新和管理問題，簡化工作流程。
衝刺規劃：該工具通過提供基於項目數據的 AI 驅動見解和建議來協助規劃衝刺。
工作流程轉換：Jira-MCP 促進不同工作流程狀態之間的平滑轉換，確保任務在無需手動干預的情況下進展。
用戶友好界面：該連接器為開發人員和項目經理提供簡單直觀的界面，使其易於集成到現有系統中。

如何使用 Jira-MCP

安裝：首先在您的 Go 環境中安裝 Jira-MCP 連接器。按照存儲庫中提供的安裝說明進行操作。
配置：配置連接器以連接到您的 Jira 實例。這通常涉及設置 API 密鑰和權限。
與 AI 助手集成：將 Jira-MCP 與您首選的 AI 助手連接。確保助手擁有與 Jira 互動所需的權限。
執行操作：利用 AI 助手執行各種 Jira 操作。您可以請求助手創建問題、更新任務或檢索項目信息。
監控和優化：持續監控連接器的性能，並根據需要優化配置以提高效率。

常見問題解答

Q1: Jira-MCP 是用什麼編程語言構建的？

A1: Jira-MCP 是使用 Go 編程語言構建的，該語言以其性能和效率而聞名。

Q2: 我可以在任何版本的 Jira 上使用 Jira-MCP 嗎？

A2: Jira-MCP 設計用於與 Atlassian Jira 一起使用，但兼容性可能根據版本而異。請始終檢查文檔以獲取特定版本要求。

Q3: 使用 Jira-MCP 是否需要付費？

A3: Jira-MCP 是開源的，供公眾使用。然而，用戶應該查看許可條款以確保合規。

Q4: 我如何能夠為 Jira-MCP 項目做出貢獻？

A4: 歡迎貢獻！您可以通過在項目的 GitHub 存儲庫中提交問題、功能請求或拉取請求來貢獻。

Q5: 我可以在哪裡找到 Jira-MCP 的支持？

A5: 支持可以通過項目的 GitHub 存儲庫獲得，用戶可以在那裡報告問題或尋求社區的幫助。

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations.

WHY

While Atlassian provides an official MCP connector, our implementation offers superior flexibility and real-world problem-solving capabilities. We've built this connector to address the daily challenges developers and project managers actually face, not just basic API operations.

Key Advantages:

More Comprehensive Tools: We provide 20+ specialized tools covering every aspect of Jira workflow management
Real-World Focus: Built to solve actual daily problems like sprint management, issue relationships, and workflow transitions
Enhanced Flexibility: Support for complex operations like moving issues between sprints, creating child issues, and managing issue relationships
Better Integration: Seamless integration with AI assistants for natural language Jira operations
Practical Design: Tools designed for actual development workflows, not just basic CRUD operations

Features

Issue Management

Get detailed issue information with customizable fields and expansions
Create new issues with full field support
Create child issues (subtasks) with automatic parent linking
Update existing issues with partial field updates
Search issues using powerful JQL (Jira Query Language)
List available issue types for any project
Transition issues through workflow states
Move issues to sprints (up to 50 issues at once)

Comments & Time Tracking

Add comments to issues
Retrieve all comments from issues
Add worklogs with time tracking and custom start times
Flexible time format support (3h, 30m, 1h 30m, etc.)

Issue Relationships & History

Link issues with relationship types (blocks, duplicates, relates to)
Get related issues and their relationships
Retrieve complete issue history and change logs
Track issue transitions and workflow changes

Sprint & Project Management

List all sprints for boards or projects
Get active sprint information
Get detailed sprint information by ID
List project statuses and available transitions
Board and project integration with automatic discovery

Advanced Features

Bulk operations support (move multiple issues to sprint)
Flexible parameter handling (board_id or project_key)
Rich formatting of responses for AI consumption
Error handling with detailed debugging information

🚀 Quick Start Guide

Prerequisites

Before you begin, you'll need:

Atlassian Account with access to a Jira instance
API Token from Atlassian (we'll help you get this)
Cursor IDE with Claude integration

Step 1: Get Your Atlassian API Token

Go to Atlassian API Tokens
Click "Create API token"
Give it a name like "Jira MCP Connector"
Copy the token (you won't see it again!)

Step 2: Choose Your Installation Method

We recommend Docker for the easiest setup:

🐳 Option A: Docker (Recommended)

### Pull the latest image
docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest

### Test it works (replace with your details)
docker run --rm \
  -e ATLASSIAN_HOST=https://your-company.atlassian.net \
  -e ATLASSIAN_EMAIL=your-email@company.com \
  -e ATLASSIAN_TOKEN=your-api-token \
  ghcr.io/nguyenvanduocit/jira-mcp:latest \
  --http_port 3000

📦 Option B: Download Binary

Go to GitHub Releases
Download for your platform:
- macOS: jira-mcp_darwin_amd64
- Linux: jira-mcp_linux_amd64
- Windows: jira-mcp_windows_amd64.exe

Make it executable (macOS/Linux):

chmod +x jira-mcp_*
sudo mv jira-mcp_* /usr/local/bin/jira-mcp

🛠️ Option C: Build from Source

go install github.com/nguyenvanduocit/jira-mcp@latest

Step 3: Configure Cursor

Open Cursor
Go to Settings → Features → Model Context Protocol
Add a new MCP server with this configuration:

For Docker Users:

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your-email@company.com", 
        "-e", "ATLASSIAN_TOKEN=your-api-token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"
      ]
    }
  }
}

For Binary Users:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira-mcp",
      "env": {
        "ATLASSIAN_HOST": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

Step 4: Test Your Setup

Restart Cursor completely
Open a new chat with Claude
Try these test commands:

List my Jira projects

Show me issues assigned to me

What's in the current sprint?

If you see Jira data, congratulations! 🎉 You're all set up.

🔧 Advanced Configuration

Using Environment Files

Create a .env file for easier management:

### .env file
ATLASSIAN_HOST=https://your-company.atlassian.net
ATLASSIAN_EMAIL=your-email@company.com
ATLASSIAN_TOKEN=your-api-token

Then use it:

### With binary
jira-mcp -env .env

### With Docker
docker run --rm -i --env-file .env ghcr.io/nguyenvanduocit/jira-mcp:latest

HTTP Mode for Development

For development and testing, you can run in HTTP mode:

### Start HTTP server on port 3000
jira-mcp -env .env -http_port 3000

Then configure Cursor with:

{
  "mcpServers": {
    "jira": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

🎯 Usage Examples

Once configured, you can ask Claude to help with Jira tasks using natural language:

Issue Management

"Create a new bug ticket for the login issue"
"Show me details for ticket PROJ-123"
"Move ticket PROJ-456 to In Progress"
"Add a comment to PROJ-789 saying the fix is ready"

Sprint Management

"What's in our current sprint?"
"Move these 3 tickets to the next sprint: PROJ-1, PROJ-2, PROJ-3"
"Show me all tickets assigned to John in the current sprint"

Reporting & Analysis

"Show me all bugs created this week"
"List all tickets that are blocked"
"What tickets are ready for testing?"

🛠️ Troubleshooting

Common Issues

❌ "Connection failed" or "Authentication error"

Double-check your ATLASSIAN_HOST (should be like company.atlassian.net)
Verify your API token is correct
Make sure your email matches your Atlassian account

❌ "No MCP servers found"

Restart Cursor completely after adding the configuration
Check the MCP configuration syntax in Cursor settings
Verify the binary path is correct (for binary installations)

❌ "Permission denied" errors

Make sure your Atlassian account has access to the Jira projects
Check if your API token has the necessary permissions

Getting Help

Check the logs: Run with -http_port to see detailed error messages
Test your credentials: Try the Docker test command from Step 2
Verify Cursor config: The app will show you the exact configuration to use

📚 Development

For local development and contributing:

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

### Create .env file with your credentials
cp .env.example .env
### Edit .env with your details

### Run in development mode
just dev
### or
go run main.go -env .env -http_port 3002

### Test with MCP inspector
npx @modelcontextprotocol/inspector http://localhost:3002/mcp

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Need help? Check our CHANGELOG.md for recent updates or open an issue on GitHub.

Jira Mcp

概覽

什麼是 Jira-MCP？

Jira-MCP 的特點

如何使用 Jira-MCP

常見問題解答

Q1: Jira-MCP 是用什麼編程語言構建的？

Q2: 我可以在任何版本的 Jira 上使用 Jira-MCP 嗎？

Q3: 使用 Jira-MCP 是否需要付費？

Q4: 我如何能夠為 Jira-MCP 項目做出貢獻？

Q5: 我可以在哪裡找到 Jira-MCP 的支持？

詳細

Jira MCP

WHY

Features

Issue Management

Comments & Time Tracking

Issue Relationships & History

Sprint & Project Management

Advanced Features

🚀 Quick Start Guide

Prerequisites

Step 1: Get Your Atlassian API Token

Step 2: Choose Your Installation Method

🐳 Option A: Docker (Recommended)

📦 Option B: Download Binary

🛠️ Option C: Build from Source

Step 3: Configure Cursor

For Docker Users:

For Binary Users:

Step 4: Test Your Setup

🔧 Advanced Configuration

Using Environment Files

HTTP Mode for Development

🎯 Usage Examples

Issue Management

Sprint Management

Reporting & Analysis

🛠️ Troubleshooting

Common Issues

Getting Help

📚 Development

🤝 Contributing

📄 License

伺服器配置

專案資訊

Jira Mcp 替代方案

複製 Flux Mcp

Mcp 連結 將任何 Openapi V3 API 轉換為 Mcp 伺服器

Pushover Mcp

Discourse Mcp 伺服器

Piapi Mcp 伺服器

Apisix 模型上下文协议 (mcp) 服务器

Mcp Xmind 伺服器

Coinmarket Mcp 伺服器

Mcp 連結將任何 Openapi V3 API 轉換為 Mcp 伺服器