Jira MCP 服务器

一个用于 Jira 的 模型上下文协议 服务器。

通过 MCP 提供与 Jira 的集成，允许 LLM 与之交互。

Jira REST API 文档

安装

手动安装

注意：需要 Node 版本为 22.12.0 或更高

1. 创建或获取 Jira 个人访问令牌：指南

2. 将服务器配置添加到 Claude Desktop：

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: 查看此指南

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

对于 Windows：

{
  "mcpServers": {
    "jira": {
      "command": "cmd /c npx",
      "args": ["-y", "@parassolanki/jira-mcp-server@latest"],
      "env": {
        "JIRA_PERSONAL_ACCESS_TOKEN": "email@example.com:your_personal_jira_access_token",
        "JIRA_BASE_URL": "jira_base_url"
      }
    }
  }
}

组件

工具

1. list_projects: 列出 Jira 中的项目。

   • 必需输入：
     • query (可选字符串): 用于过滤返回项目的查询字符串。
     • maxResults (可选数字, 最大值: 100): 要返回的最大结果数。
     • expand (可选字符串): 在响应中展开其他信息。（逗号分隔 description, lead, issueTypes, url, projectKeys, permissions 和 insight）。

2. list_boards: 列出项目中的看板。

   • 必需输入：
     • projectKeyOrId (字符串): 项目的 Key 或 Id。
     • name (可选字符串): 项目的名称。
     • maxResults (可选数字, 最大值: 100): 要返回的最大结果数。
     • startAt (可选数字): 返回的看板的起始索引。
     • type (可选字符串): 看板的类型。（可以是 scrum 或 kanban 之一）。

3. list_sprints_from_board: 列出看板中的冲刺。

   • 必需输入：
     • boardId (字符串): 看板的 ID。
     • maxResults (可选数字, 最大值: 100): 要返回的最大结果数。
     • startAt (可选数字): 返回的看板的起始索引。

4. list_issues_from_sprint: 列出冲刺中的问题。

   • 必需输入：
     • boardId (字符串): 看板的 ID。
     • sprintId (字符串): 冲刺的 ID。
     • maxResults (可选数字, 最大值: 100): 要返回的最大结果数。
     • startAt (可选数字): 返回的看板的起始索引。
     • expand (可选字符串): 在响应中展开其他信息。（逗号分隔 schema 和 names）。

使用示例

一些可以用来与 Jira 交互的示例提示：

1. "显示我所有的 Jira 项目" → 执行 list_projects 工具以查看所有可用的项目。
2. "DEV 项目中存在哪些看板？" → 执行 list_boards 工具，并将 DEV 项目键和 type 参数设置为 "kanban"。
3. "显示我看板 ID 123 的所有冲刺" → 执行 list_sprints_from_board 工具以查看与看板 123 关联的所有冲刺。
4. "看板 123 上冲刺 456 中有哪些问题？" → 执行 list_issues_from_sprint 工具以查看看板 123 上冲刺 456 中的所有问题。
5. "显示我 Marketing 看板上当前冲刺的前 50 个问题" → 首先执行 list_boards 以找到 Marketing 看板 ID，然后执行 list_sprints_from_board 以找到当前冲刺，然后执行 list_issues_from_sprint 并设置 maxResults=50。

开发

1. 安装依赖项：

pnpm install

2. 在 .env 中配置 Github 访问令牌：

JIRA_PERSONAL_ACCESS_TOKEN=email@example.com:your_personal_jira_access_token
JIRA_BASE_URL=jira_base_url

3. 在本地运行并监听更改：

pnpm dev

4. 构建服务器：

pnpm build

5. 使用 inspector 进行本地调试：

pnpm inspector

待办事项

• [x] list_projects
• [x] list_boards
• [x] list_sprints_from_board
• [x] list_issues_from_sprint
• [ ] get_issue_by_id_or_key
• [ ] create_issue
• [ ] update_issue
• [ ] delete_an_issue
• [ ] archieve_an_issue
• [ ] list_comments_from_issue
• [ ] get_comment_from_issue_by_id
• [ ] create_comment_in_issue
• [ ] update_comment_of_issue
• [ ] delete_comment_of_issue
• [ ] list_subtasks_from_issue
• [ ] get_user_by_username_or_key