Jira问题跟踪服务器

一个基于FastMCP和Jira REST API v3构建的轻量级MCP服务器,为Claude Code提供Jira问题搜索、读取、项目管理及状态流转等集成能力。

  • by mumnik
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mumnik/jira-mcp-server

使用说明

Jira MCP Server

A lightweight Jira MCP server for Claude Code, built with FastMCP and the Jira REST API v3.

Tools

  • search_issues - Search issues using JQL
  • read_issue - Get full details of an issue (description, transitions, etc.)
  • list_projects - List all accessible projects
  • my_open_issues - Shortcut for unresolved issues assigned to you
  • add_comment - Add a comment to an issue
  • transition_issue - Change issue status (e.g. move to "In Progress", "Done")

Setup

Prerequisites

  • Python 3.10+
  • uv (recommended) or pip

1. Configure environment

Copy .env.example to .env and fill in your Jira credentials:

cp .env.example .env

You'll need a Jira API token.

2. Register with Claude Code

claude mcp add-json jira '{
  "command": "uv",
  "args": ["run", "/path/to/jira-server/server.py"],
  "env": {
    "JIRA_URL": "https://your-domain.atlassian.net",
    "JIRA_USERNAME": "your-email@example.com",
    "JIRA_API_TOKEN": "your-api-token"
  }
}'

Or add it manually to ~/.claude.json under mcpServers.

3. Restart Claude Code

The tools will be available as mcp__jira__*.

Dependencies

Managed inline via PEP 723 script metadata — no requirements.txt needed. uv run handles it automatically.

  • fastmcp>=2.0
  • httpx