Jira MCP 服务器

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

**作者：**塞缪尔·里佐

特征

• 列出所有 Jira 项目
• 获取详细的问题信息
• 按项目和受让人搜索问题
• 列出项目成员
• 检查用户的项目成员资格和分配的问题
• 使用自定义字段创建新问题
• 带有过滤选项的列表和查询冲刺

安装

配置

MCP 服务器配置

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

设置 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 ：（可选）问题类型（例如“任务”、“错误”、“故事”），默认为“任务”
• assigneeName ：（可选）分配问题的人员的显示名称
• reporterName ：（可选）报告问题的人的显示名称
• sprintId ：（可选）要添加问题的 sprint 的 ID
• jiraHost ：您的 Jira 域名
• email ：您的 Jira 电子邮件
• apiToken ：您的 Jira API 令牌

7. 列出 Sprint（ mcp_jira_list_sprints ）

使用过滤选项列出 Jira 中的当前冲刺。

参数：

• boardId ：（可选）Jira board ID，用于按特定 board 过滤 sprint
• projectKey ：（可选）项目键，用于查找与项目相关的冲刺
• state ：（可选）要过滤的 Sprint 状态（活动、未来、关闭或全部），默认为“活动”
• jiraHost ：您的 Jira 域名
• email ：您的 Jira 电子邮件
• apiToken ：您的 Jira API 令牌

使用示例

以下是一些可以与 Claude 一起使用的示例查询：

持续发展

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

• 附加问题管理工具
• 冲刺和董事会管理
• 高级搜索和过滤选项
• 自定义字段处理
• 工作流程转换
• 还有更多！

请关注或为存储库加星标以获取更新。

贡献

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

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

开源

此代码完全开源。您可以自由地：

• 复制
• 调整
• 分发
• 商业用途
• 私下使用

没有限制——用代码做任何你想做的事！

执照

麻省理工学院