STARWARCLOUD STARWAR.AI
返回市场
杰拉-MCP服务器

杰拉-MCP服务器

作者：samuelrizzo2 星标更新：2025-08-07
安装使用来源：spider==github.com

项目介绍

Jira MCP Server

<div align="center">

TypeScript Node.js Jira NPM License PRs Welcome

</div>

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

<div align="center"> <img src="https://skillicons.dev/icons?i=ts,nodejs,git" alt="技能" /> </div>

作者: Samuel Rizzo

<div align="center">

GitHub粉丝 Twitter关注

</div>

功能

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

安装

# 克隆仓库
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# 安装依赖
npm install

# 构建项目
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: （可选）问题类型（例如：'任务'，'错误'，'故事'），默认为'任务'
  • assigneeName: （可选）要分配给该问题的人的显示名
  • reporterName: （可选）报告该问题的人的显示名
  • sprintId: （可选）要将问题添加到的冲刺ID
  • jiraHost: 您的Jira域名
  • email: 您的Jira电子邮件
  • apiToken: 您的Jira API令牌

7. 列出冲刺 (mcp_jira_list_sprints)

列出当前的Jira冲刺，带有过滤选项。

参数：

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

使用示例

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

"列出PROJECT中的所有Jira项目"
"获取问题PROJECT-123的详细信息"
"搜索分配给John的PROJECT中的问题"
"列出PROJECT的所有成员"
"检查Jane在PROJECT中被分配了哪些问题"
"在PROJECT中创建一个新的标题为'登录页面错误'的错误问题"
"列出PROJECT的活动冲刺"

持续开发

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

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

通过关注或星标此存储库来了解更新。

贡献

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

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

开源

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

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

无任何限制——随心所欲地使用代码！

许可证

MIT