SJ

stolostron/jira-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

2 stars 13 forks 品質 82 トレンド 22Apache-2.0

A Model Context Protocol (MCP) server that provides seamless integration with Jira instances. This server enables AI applications to interact with Jira issues, projects, and workflows through a...

概要

A Model Context Protocol (MCP) server that provides seamless integration with Jira instances. This server enables AI applications to interact with Jira issues, projects, and workflows through a standardized interface. The server has been updated to work with the new Jira Cloud instance. To migrate: 3. — Go to https://id.atlassian.com/manage-profile/security/api-tokens and click "Create API token" 4. — In Claude Code run /mcp to reconnect, or restart your client (Cursor, Gemini CLI, etc.) All custom field IDs and activity type IDs have been updated in the code. No other changes needed. - : Search, create, update, and transition Jira issues - : Define teams with multiple members and assign them to issues as watchers - : Use short, memorable aliases instead of long component names - : Add, remove, and list watchers on issues - : Create links between issues with different relationship types (blocks, relates to, etc.

README

以下は原文 README の抜粋です。原文を見る。

Jira MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Jira instances. This server enables AI applications to interact with Jira issues, projects, and workflows through a standardized interface.

Jira Cloud Migration

The server has been updated to work with the new Jira Cloud instance. To migrate:

  1. Pull the latest changes
cd /path/to/jira-mcp-server && git pull
  1. Update your .env file
JIRA_SERVER_URL=https://redhat.atlassian.net
JIRA_ACCESS_TOKEN=
[email protected]
  1. Get your API token — Go to https://id.atlassian.com/manage-profile/security/api-tokens and click “Create API token”

  2. Reconnect — In Claude Code run /mcp to reconnect, or restart your client (Cursor, Gemini CLI, etc.)

All custom field IDs and activity type IDs have been updated in the code. No other changes needed.

Table of Contents

  1. Features
  2. Installation
  3. Configuration
  4. Usage
  5. Client Configuration
  6. Available Tools
  7. Slash Commands
  8. Automatic Update Notifications
  9. Development
  10. Troubleshooting
  11. Advanced Configuration
  12. License & Contributing

Features

  • Issue Management: Search, create, update, and transition Jira issues
  • Team Management: Define teams with multiple members and assign them to issues as watchers
  • Component Aliases: Use short, memorable aliases instead of long component names
  • Watcher Management: Add, remove, and list watchers on issues
  • Issue Linking: Create links between issues with different relationship types (blocks, relates to, etc.)
  • Project Access: List and browse Jira projects and components
  • User Search: Find Jira users by name, email, or username for assignment
  • Comments: Add, edit, and delete issue comments with safe visibility handling
  • Time Logging: Log work time on issues with detailed comments
  • Workflow Enforcement: Requires fix_version before transitioning beyond “In Progress”
  • JQL Support: Full Jira Query Language support for advanced searching
  • Rate Limiting: Built-in throttling to respect Jira API limits
  • Async Operations: Fully asynchronous for optimal performance
  • Type Safety: Pydantic models for structured data validation
  • Multiple Transports: Support for both STDIO and SSE (HTTP) transports
  • Client Integration: Works with Claude Code, Gemini CLI, Cursor, and other MCP clients

Installation

  1. Clone the repository:
git clone https://github.com/stolostron/jira-mcp-server.git
cd jira-mcp-server
GitHub で README 全文を見る

インストール

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

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "jira-mcp-server": { "command": "python", "args": ["-m", "jira_mcp_server.main"], "cwd": "/home/user/workspace_git/jira-mcp-server", } } }