AI导哈

Jira MCP服务器

一个用于Jira集成的模型上下文协议（MCP）服务器，允许AI助手通过MCP与Jira交互。

  • by samuelrizzo
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 samuelrizzo/jira-mcp-server

使用说明

Jira MCP服务器

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

作者 塞缪尔·里佐

特性

  • 列出所有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服务器配置

将以下配置添加到您的游标/wundsurf 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域名（例如，“您的域名.atlassian.net”）
  • email：您的Jira电子邮件
  • apiToken：您的Jira API代币

2.获取问题详细信息(mcp_jira_get_issue)

检索有关特定Jira问题的详细信息。

参数：

  • issueKey：Jira问题密钥（例如，“项目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：（可选）问题类型（例如，“任务”、“Bug”、“故事”），默认为“任务”
  • assigneeName：（可选）将问题分配给的人员的显示名称
  • reporterName：（可选）报告问题的人员的显示名称
  • sprintId：（可选）要将问题添加到的sprint的ID
  • jiraHost：您的Jira域名
  • email：您的Jira电子邮件
  • apiToken：您的Jira API代币

7.列出精灵(mcp_jira_list_sprints)

列出Jira中具有筛选选项的当前冲刺。

参数：

  • boardId：（可选）Jira板ID，用于按特定板过滤冲刺
  • projectKey：（可选）项目键，用于查找与项目关联的冲刺
  • state：（可选）要筛选的Sprint状态（活动、未来、关闭或全部），默认为“活动”
  • 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的集成能力。未来的更新将包括：

  • 其他问题管理工具
  • Sprint和董事会管理
  • 高级搜索和筛选选项
  • 自定义字段处理
  • 工作流转换
  • 还有更多！

请继续关注或关注存储库以获取更新。

贡献

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

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

开源

这段代码是完全开源的。您可以自由地：

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

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

许可证

麻省理工学院

相关 MCP