吉拉易mcp
](https://www.npmjs.com/package/jira-easy-mcp) ](https://github.com/IamSAL/jira-easy-mcp)
Jira的另一个模型上下文协议(MCP)服务器,没有Auth令牌。提供完整的Jira自动化工具,包括问题、项目、公告板、冲刺、评论、工作日志等。
测试时间: Jira Server v7.12.3(自托管)
______________________________________________________________________
🔑 为什么选择MCP?
适用于基本身份验证(用户名+密码) -不需要API令牌!
大多数Jira MCP服务器需要OAuth或API令牌,这是许多组织限制或不允许的。此MCP使用 HTTP基本认证,因此您可以仅使用Jira用户名和密码进行连接。非常适合:
- 🏢 企业环境 其中管理员不允许创建API令牌
- 🔒 自托管Jira服务器 未配置OAuth的实例
- ⚡ 快速设置 不经过IT审批流程
______________________________________________________________________
快速开始
VS代码(工作区配置)
创建 .vscode/mcp.json 在您的工作区根目录中:
{
"servers": {
"jira": {
"type": "stdio",
"command": "npx",
"args": ["-y", "jira-easy-mcp"],
"env": {
"JIRA_BASE_URL": "https://your-jira-instance.com",
"JIRA_USERNAME": "your-username",
"JIRA_PASSWORD": "your-password",
"JIRA_PROJECTS_FILTER": "ABC,DEF,XYZ",
"JIRA_RESPONSE_FORMAT": "JSON"
}
}
}
}添加到您的VS代码设置中,以便在所有工作区中访问。
注:JIRA_PROJECTS_FILTER和JIRA_RESPONSE_FORMAT是可选的。项目筛选器限制对指定项目的访问。响应格式可以是JSON(默认)或TOON(面向文本的符号)。
其他IDE
光标: 手动将上述配置添加到光标设置中(使用 "mcp": { "servers": { ... } } 包装)\ 风浪: 添加到您的Windsurf MCP设置中:(使用 "mcp": { "servers": { ... } } 包装)\ 克劳德桌面: 编辑 ~/.claude/mcp.json (使用 "mcpServers": { ... } 包装)
所有使用相同 command, args,以及 env 配置为上述VS代码。
______________________________________________________________________
常见用例
| 任务 | 工具 | 示例提示 |
|---|---|---|
| 搜索问题 | jira_search | “搜索ABC项目中分配给我的所有打开的bug” |
| 获取问题详细信息 | jira_get_issue | “显示ABC-123问题的详细信息” |
| 创建问题 | jira_create_issue | “在ABC项目中创建一个标题为“登录按钮不起作用”的新错误” |
| 更新问题 | jira_update_issue | “将ABC-123的优先级更改为高,并将其分配给john.doe” |
| 添加注释 | jira_add_comment | “在ABC-123中添加一条评论,说‘修复部署到暂存的问题’” |
| 更改状态 | jira_transition_issue | “将ABC-123移动到完成” |
| 对数时间 | jira_add_worklog | “昨天在ABC-123上记录2小时的工作” |
| 列出项目 | jira_get_projects | “显示我有权访问的所有项目” |
| 查看冲刺 | jira_get_sprints | “ABC项目目前的冲刺是什么?” |
| 链接问题 | jira_create_link | “将ABC-123链接为阻止ABC-124” |
| 生成筛选器URL | jira_generate_filter_url | “为过去7天内更新的所有打开的bug创建一个可共享的链接” |
______________________________________________________________________
MCP检验员测试
MCP检查器提供了一个web UI,用于交互式测试所有工具:
npx @modelcontextprotocol/inspector npx jira-easy-mcp这将在以下位置打开浏览器 http://localhost:6274 您可以在哪里:
- 查看所有可用工具
- 使用自定义参数测试每个工具
- 查看原始JSON响应
注: 在连接之前,将这些值放入检查器UI中:JIRA_BASE_URL,JIRA_USERNAME,JIRA_PASSWORD.
______________________________________________________________________
可选环境变量
| 变量 | 默认值 | 描述 |
|---|---|---|
JIRA_PROJECTS_FILTER | *(无)* | 逗号分隔的项目密钥以限制访问 |
JIRA_RESPONSE_FORMAT | JSON | 响应格式: JSON 或 TOON |
JIRA_LOG_LEVEL | INFO | 日志冗长: DEBUG, INFO, WARN, ERROR |
JIRA_TIMEOUT | 30000 | 请求超时(毫秒) |
JIRA_RETRY_COUNT | 3 | 失败请求的重试次数 |
JIRA_RETRY_DELAY | 1000 | 重试之间的基本延迟(ms) |
JIRA_SSL_VERIFY | true | 设置为 false 跳过SSL验证 |
JIRA_CACHE_TTL | 300 | 缓存静态数据的TTL(秒) |
______________________________________________________________________
兼容性
| Jira版本 | 状态 |
|---|---|
| Jira服务器v7.12.3 | ✅ 已测试 |
| Jira服务器v8.x✅ 已测试 | |
| Jira Cloud | ➢未测试(使用官方MCP) |
您可以通过以下方式对此进行改进 报告问题
