sthirugn/jira-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

5 stars 8 forks 质量 68 趋势 13MIT

Repository Install

MCP server for Jira integration with AI assistants

概览

A clean and focused Model Context Protocol (MCP) server that provides seamless integration between AI assistants and Jira, enabling natural language interaction with your Jira projects, issues, and workflows. - for full Jira interaction - - Ask AI to manage your Jira work - - Get current project status and issue information - - API token-based authentication - - Works with any MCP-compatible client - - Simple configuration and testing - Python 3.8 or higher - Jira account with API access - MCP-compatible client (Cursor, VS Code, etc.) Create a .env file with your Jira details: 1. Go to https://id.atlassian.com/manage-profile/security/api-tokens 2. Click "Create API token" 3. Copy the token to your .env file - Use the full absolute path to server.py!

README

以下为原文 README 节选，完整内容请查看原文。

Jira MCP Server

🎯 Features

11 Comprehensive Tools for full Jira interaction
Natural Language Interface - Ask AI to manage your Jira work
Real-time Updates - Get current project status and issue information
Secure Authentication - API token-based authentication
Cross-platform - Works with any MCP-compatible client
Easy Setup - Simple configuration and testing

🛠️ Available Tools

Tool	Description	Example Usage
`get_issue`	Get detailed issue info	`get_issue(issue_key="PROJ-12345")`
`search_issues`	Search with JQL	`search_issues(jql="project = PROJ")`
`create_issue`	Create new issue	`create_issue(project_key="PROJ", issue_type="Bug", summary="...")`
`update_issue`	Update existing issue	`update_issue(issue_key="PROJ-12345", summary="New title")`
`add_comment`	Add comment to issue	`add_comment(issue_key="PROJ-12345", comment="...")`
`get_comments`	Get all comments	`get_comments(issue_key="PROJ-12345")`
`transition_issue`	Move through workflow	`transition_issue(issue_key="PROJ-12345", transition_name="In Progress")`
`get_project`	Get project info	`get_project(project_key="PROJ")`
`get_issue_types`	Get available types	`get_issue_types(project_key="PROJ")`
`get_my_issues`	Get assigned issues	`get_my_issues(max_results=20)`
`get_project_issues`	Get project issues	`get_project_issues(project_key="PROJ")`

🚀 Quick Start (5 minutes)

Prerequisites

Python 3.8 or higher
Jira account with API access
MCP-compatible client (Cursor, VS Code, etc.)

1. Clone and Setup

cd jira-mcp-server
pip install -r requirements.txt

2. Configure Credentials

Create a .env file with your Jira details:

JIRA_SERVER=https://your-company.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token

Getting Your API Token:

Go to https://id.atlassian.com/manage-profile/security/api-tokens
Click “Create API token”
Copy the token to your .env file

3. Test Connection

python3 test_connection.py

4. Configure MCP Client

For Cursor:

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "python3",
      "args": ["/full/path/to/jira-mcp-server/server.py"],
      "env": {
        "JIRA_SERVER": "https://your-company.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

For VS Code:

Add to your VS Code MCP configuration:

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "python3",

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "python3",
      "args": ["/full/path/to/jira-mcp-server/server.py"],
      "env": {
        "JIRA_SERVER": "https://your-company.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}