AI导哈

Jira MCP 服务器

一个用于Claude代码与Jira Server实例集成的Jira MCP（模型上下文协议）服务器，支持旧版Jira Server 8.x。

  • by sean2077
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 sean2077/jira-mcp-server

使用说明

jira mcp服务器

用于与Jira服务器实例集成Claude代码的Jira MCP（模型上下文协议）服务器。

为什么是这个项目？

大众 索珀塞特/mcp澳大利亚 需要 Jira服务器8.14+，对于运行旧版Jira的组织来说，这可能不可行，因为：

  • 遗留系统依赖关系
  • 合规或安全政策
  • 成本约束
  • 插件兼容性问题

该项目提供了一种替代的MCP服务器 Jira服务器8.x （在8.1上测试），为坚持使用旧版本的团队提供AI驱动的Jira集成。

分叉信息

基于 @aot tech/jira mcp服务器 v1.0.9。

关键修改：

  • 启用已注释掉的问题操作工具
  • 修复了身份验证错误：服务现在可以正确使用Jira Server的Basic Auth
  • 修复了更新/删除/分配操作的空响应处理（Jira服务器返回204）
  • 添加了工作流转换、问题链接、工作日志和观察者工具
  • 通过优先级、标签、组件、修复版本和问题链接增强问题输出
  • 添加了与Vitest的集成测试

支持的工具

问题

工具 说明
jira_search_issues 通过JQL搜索问题
jira_get_issue_info 获取单期详细信息
jira_create_issue 创建新问题
jira_update_issue 更新现有问题
jira_delete_issue 删除问题
jira_assign_issue 将问题分配给用户
jira_add_comment_to_issue 向问题添加评论

工作流程

工具 说明
jira_get_transitions 获取问题的可用状态转换
jira_transition_issue 向新状态的过渡问题

问题链接

工具 说明
jira_get_issue_link_types 获取可用的链接类型（块、关联等）
jira_create_issue_link 在两个问题之间建立联系
jira_delete_issue_link 删除问题链接

时间跟踪

工具 说明
jira_add_worklog 记录在问题上花费的时间

观察者

工具 说明
jira_get_watchers 让观察者关注问题
jira_manage_watchers 添加或删除观察者

项目

工具 说明
jira_get_all_projects 列出所有项目
jira_get_project_details 获取项目详细信息
jira_get_project_users 获取项目成员

用户

工具 说明
jira_get_current_user 获取当前用户
jira_get_user_profile 获取用户资料
jira_lookup_account_id 按名称查找用户

元数据

工具 说明
jira_get_issue_types 获取问题类型
jira_get_priorities 确定优先事项
jira_get_statuses 获取状态
jira_get_fields 获取所有字段，包括自定义字段
jira_get_workflows 按问题类型获取工作流状态

木板和Sprints

工具 说明
jira_get_boards 获取公告板
jira_get_sprints 冲刺

分析

工具 说明
jira_bulk_user_analytics 用户分析
jira_bulk_project_analytics 项目分析

安装

# Clone the repository
git clone <repo-url>
cd jira-mcp-server

# Install dependencies
npm install

# (Optional) Install globally
npm install -g .

配置

环境变量

变量 描述 示例
JIRA_TYPE Jira部署类型 server 或 cloud
JIRA_BASE_URL Jira服务器URL http://jira.example.com:8080
JIRA_USER_EMAIL 用户名 username
JIRA_API_TOKEN API令牌或密码 password

Claude代码配置

编辑 ~/.claude.json:

{
  "mcpServers": {
    "jira": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/jira-mcp-server/src/index.js"],
      "env": {
        "JIRA_TYPE": "server",
        "JIRA_BASE_URL": "http://jira.example.com:8080",
        "JIRA_USER_EMAIL": "your_username",
        "JIRA_API_TOKEN": "your_password"
      }
    }
  }
}

测试

# Configure test credentials
cp tests/.env.test.example tests/.env.test
# Edit tests/.env.test with your Jira credentials

# Run tests
npm test

测试配置(tests/.env.test):

JIRA_BASE_URL=http://jira.example.com:8080
JIRA_USER_EMAIL=username
JIRA_API_TOKEN=password
TEST_PROJECT_KEY=MYPROJECT    # Optional
TEST_ISSUE_KEY=MYPROJECT-1    # Optional

开发依赖性说明：Vitest 3可以解析Vite 5、6或7。这个项目保持了直接 vite@^6.4.2 dev依赖性，因此测试树保持在仍然支持Node 18的安全Vite线上。

兼容性

平台 版本 状态
Jira服务器 8.x+ ✅ 8.1测试
吉拉云 - ✅ 支持
Node.js 18.14.1+ ✅ 必填项

与备选方案的比较

专题 本项目 mcp atlasian
Jira服务器8.1 ✅ ❌ 需要8.14+
Jira Cloud✅ ✅
发出CRUD命令 ✅ ✅
搜索（JQL） ✅ ✅
工作流转换 ✅ ✅
问题链接 ✅ ❌
工作日志 ✅ ❌
观察者 ✅ ❌
汇流 ❌ ✅
语言 JavaScript Python

许可证

麻省理工学院（继承自原始项目）

相关 MCP