Jira MCP 服务器

这是一个用于 Jira 集成的模型上下文协议 (MCP) 服务器。该服务器允许像 Claude 这样的 AI 助手通过 MCP 与 Jira 交互。

作者: Samuel Rizzo

特性

• 列出所有 Jira 项目
• 获取详细的事务信息
• 按项目和指派人搜索事务
• 列出项目成员
• 检查用户的项目成员资格及分配的事务
• 使用自定义字段创建新事务
• 列出并查询具有过滤选项的冲刺

安装

# Clone the repository
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

配置

MCP 服务器配置

将以下配置添加到您的 cursor/windsurf mcp 设置文件中：

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

设置 API 访问

1. 生成 Jira API 令牌：

   • 前往 Atlassian 账户设置
   • 点击“创建 API 令牌”
   • 给它一个名称，然后点击“创建”
   • 复制令牌（您需要它进行身份验证）

2. 记下您的 Jira 主机 URL（例如 your-domain.atlassian.net）以及与您的 Atlassian 账户关联的电子邮件地址。

3. 将这些凭据添加到您的 MCP 服务器配置中。

可用工具

1. 列出项目 (mcp_jira_list_projects)

列出认证用户有权访问的所有 Jira 项目。

参数：

• jiraHost: 您的 Jira 域名（例如 'your-domain.atlassian.net'）
• email: 您的 Jira 电子邮件
• apiToken: 您的 Jira API 令牌

2. 获取事务详情 (mcp_jira_get_issue)

检索特定 Jira 事务的详细信息。

参数：

• issueKey: Jira 事务键（例如 'PROJECT-123'）
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 电子邮件
• apiToken: 您的 Jira API 令牌

3. 搜索事务 (mcp_jira_search_issues)

在特定项目中搜索事务，可选地按指派人过滤。

参数：

• projectKey: Jira 项目密钥
• assigneeName: （可选）按指派人员名称过滤问题
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 邮箱
• apiToken: 您的 Jira API 令牌

4. 列出项目成员 (mcp_jira_list_project_members)

列出特定 Jira 项目的所有成员。

参数：

• projectKey: Jira 项目密钥
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 邮箱
• apiToken: 您的 Jira API 令牌

5. 检查用户问题 (mcp_jira_check_user_issues)

检查用户是否是项目的成员，并列出分配给他们的问题。

参数：

• projectKey: Jira 项目密钥
• userName: 要检查的用户的显示名称
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 邮箱
• apiToken: 您的 Jira API 令牌

6. 创建问题 (mcp_jira_create_issue)

在 Jira 项目中使用指定详细信息创建新问题。

参数：

• projectKey: Jira 项目密钥
• summary: 问题的标题/摘要
• description: 问题的详细描述
• issueType: （可选）问题类型（例如，'Task', 'Bug', 'Story'），默认为 'Task'
• assigneeName: （可选）要将问题分配给的人的显示名称
• reporterName: （可选）报告问题的人的显示名称
• sprintId: （可选）要将问题添加到的冲刺 ID
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 邮箱
• apiToken: 您的 Jira API 令牌

7. 列出冲刺 (mcp_jira_list_sprints)

列出 Jira 中的当前冲刺，并提供过滤选项。

参数：

• boardId: （可选）Jira 看板 ID，用于通过特定看板过滤冲刺
• projectKey: （可选）项目密钥，用于查找与项目关联的冲刺
• state: （可选）冲刺状态，用于过滤（active, future, closed, 或 all），默认为 'active'
• jiraHost: 您的 Jira 域名
• email: 您的 Jira 邮箱
• apiToken: 您的 Jira API 令牌

使用示例

这里有一些您可以与 Claude 一起使用的示例查询：

"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"
"Search for issues assigned to John in PROJECT"
"List all members of PROJECT"
"Check what issues are assigned to Jane in PROJECT"
"Create a new bug issue titled 'Login page error' in PROJECT"
"List active sprints for PROJECT"

持续开发

此项目正在积极开发中。新的工具和功能正在定期添加，以扩展与 Jira 的集成能力。未来的更新将包括：

• 额外的问题管理工具
• 冲刺和看板管理
• 高级搜索和过滤选项
• 自定义字段处理
• 工作流转换
• 更多！

请通过关注或标星仓库来获取更新。

贡献

这是一个开源项目，欢迎贡献！要贡献：

1. 叉仓库
2. 创建您的功能分支
3. 进行更改
4. 提交拉取请求

开源

此代码完全开源。您有权：

• 复制
• 修改
• 分发
• 商业使用
• 私人使用

没有任何限制 - 随意处置代码！

许可证

MIT