Jira MCP Server（免费版友好）

一个轻量级 MCP 服务器，让 MCP 客户端（Claude Desktop 或任何 MCP 客户端）能够读取、创建、更新、评论和流转 Jira 问题。基于 Jira Cloud 的免费套餐构建和测试——无需付费 Jira 订阅。

它提供的工具

1. 获取免费的 Jira Cloud 站点

1. 前往 https://www.atlassian.com/software/jira 注册（免费，最多 10 个用户，无限项目）。

2. 创建一个项目并记下其项目键（例如 PROJ）——显示在项目名称旁边。

3. 在 https://id.atlassian.com/manage-profile/security/api-tokens 创建 API 令牌。

2. 安装依赖

cd jira-mcp-server
python3 -m venv venv
source venv/bin/activate        # on Windows: venv\Scripts\activate
pip install -r requirements.txt

3. 配置凭据

将 .env.example 复制为 .env 并填写你的值，或者直接在 shell 中导出它们：

export JIRA_BASE_URL=https://yourcompany.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token-here

4. 直接测试（无需 Claude Desktop）

编辑 test_client.py 顶部的 PROJECT_KEY / ISSUE_KEY 以匹配你的 Jira 项目，然后：

python test_client.py

这会通过 stdio 将 jira_server.py 作为子进程启动（与真实 MCP 客户端的方式相同），列出可用工具，并针对你的在线 Jira 站点执行 get_issue、search_issues 和 create_issue。

5. 将其接入 Claude Desktop（可选）

将此添加到你的 Claude Desktop MCP 配置中（claude_desktop_config.json — 设置 → 开发者 → 编辑配置）：

{
  "mcpServers": {
    "jira": {
      "command": "/absolute/path/to/jira-mcp-server/venv/bin/python",
      "args": ["/absolute/path/to/jira-mcp-server/jira_server.py"],
      "env": {
        "JIRA_BASE_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

重启 Claude Desktop，然后问它类似"PROJ-1 的状态是什么？"的问题——它应该会调用 get_issue 工具。

注意事项 / 常见坑

• Jira 的 v3 API 以 Atlassian 文档格式（ADF）存储描述和评论，而非纯文本。服务器会为你处理双向转换。

• create_issue 的 issue_type 必须与该项目上配置的类型完全匹配（通常是 Task、Bug、Story、Epic）——如果遇到"issuetype"错误，请检查你项目的问题类型。

• 免费套餐限制你每月 100 次自动化运行和 2 GB 存储——对于这种手动/API 测试来说无关紧要，但值得了解。

• 此服务器使用 stdio 传输，意味着它仅在本地运行，由与之通信的任何 MCP 客户端启动——它不是公共 Web 服务，这是测试 MCP 最简单、最常见的方式。